Docs
Sign in

Klaviyo connector

Updated May 26, 20262 min read

The Klaviyo connector sends shipment status events from Carriyo to Klaviyo. In Klaviyo, the events appear as a new metric called Carriyo Shipment Status Update. Use that metric to trigger workflows for automated customer notifications.

Capabilities

  • Customizable shipment triggers: choose which shipment status events to send to Klaviyo. For example, send updates when a shipment is Booked, Shipped, or Delivered. To track failed deliveries, also send Failed Delivery Attempt events.
  • Real-time updates: Carriyo sends status updates in real time so you can trigger customer notifications as shipment status changes.

Setting up

The only data you need from Klaviyo is a private API key with the right permissions. Fields marked with an asterisk (*) are mandatory.

1. In the Carriyo Dashboard, navigate to Integrations → Connectors and click the Klaviyo connector to create a new instance.

2. Choose a name for the connector and select the merchant whose shipment statuses should be sent to Klaviyo. Make sure the connector is Active — events are not sent otherwise.

3. Open Klaviyo and go to Settings → Account → API Keys. Under Private API keys, click Create Private API Key.

4. Give the key a name. Set the access level to Custom for the Events row and grant it Full access. Click Create. Copy the generated key and paste it into the API Key field in Carriyo.

5. Select the shipment status events you want sent to Klaviyo and click Save.

The new Klaviyo connector now appears in your connectors list.

Setup is complete. Whenever a shipment status event for the selected merchant occurs, the data is sent to Klaviyo automatically.

Viewing events in Klaviyo

In the Klaviyo dashboard, go to Analytics → Metrics and open Carriyo Shipment Status Update to monitor and analyze the received events.

Further configuration

For the Chart and Activity Feed sections in Klaviyo, the variables (attributes) in the event payload can be used to filter events. The dropdown shows values that are present in payloads for past events sent to Klaviyo.

You can inspect the payload of any event sent to Klaviyo by clicking the downward arrow next to the user record.