How to set up Klaviyo

Table of Contents

• Watch the video
• Set up Klaviyo in Starshipit
• How to get your Klaviyo private API key
• How to create an email notification flow in Klaviyo
• How to trigger different emails based on tracking status
• FAQs
• Troubleshooting

Overview

• Our integration with Klaviyo enables you to sync shipping events and status updates with your Klaviyo account. You can use these as part of your Klaviyo email flows and to personalise emails.
• This article provides a guide on how to integrate Klaviyo with Starshipit.

Watch the video

Set up Klaviyo in Starshipit

1. In Starshipit, navigate to Settings > Tracking and notifications.
2. Scroll down to Set up Klaviyo.
3. Tick the checkbox next to Enable Klaviyo.
4. Add your Klaviyo private key to the Klaviyo API key field (See section below).
5. Click Save.

How to get your Klaviyo private API key

1. Sign in to your Klaviyo account.
2. From the navigation menu, click on your user details then select Settings.
3. Click API Keys.
4. Copy the API Key from the section labelled as Private API keys.
   Note: You can generate a new API key specifically for Starshipit by selecting Create Private API Key.
5. Enter your API key in the Klaviyo API key field in Starshipit.

How to create an email notification flow in Klaviyo

1. Sign in to Klaviyo.
2. Navigate to Flows.
3. Click Create Flow.
4. Click Create from scratch.
5. Enter a name for the flow and click Create Flow.
6. To set the notification trigger, select Metric.
7. From the dropdown menu, select Starshipit Tracking status.
   If you don't see this option, read this troubleshooting step.
8. Click Done.
9. Drag and drop the Email option into the flow.
10. To make edits, click on ... and then select Edit within the email action.
11. To customise your email content, you can use the following dynamic variables:
    

    Order Number -> {{ event.orderNumber|default:'' }}

    Tracking Status -> {{ event.trackingStatus|default:'' }}

    Tracking Number -> {{ event.trackingNumber|default:'' }}

    Tracking Url -> {{ event.trackingUrl|default:'' }}

    Carrier -> {{ event.carrier|default:'' }}

12. Click on Review and Turn On to activate the notification.
13. Click Exit when you've finished.

How to trigger different emails based on tracking status

1. Sign in to Klaviyo.
2. Navigate to Flows.
3. In the Logic section, choose Trigger Split and drag it beneath the trigger action.
4. In the Configuration settings, click on Dimension.
5. Click trackingStatus.
6. Input the tracking status and the condition that should prompt the notification.
7. Repeat the process of adding a trigger split for each tracking status that requires a notification.

FAQs

How soon does Starshipit transmit tracking updates to Klaviyo?

Starshipit sends tracking updates to Klaviyo instantly once it receives updated information from the supported carrier.

Which events trigger updates in Starshipit for Klaviyo?

Starshipit triggers Klaviyo updates during the following stages:

• Print
• Dispatch
• In-transit
• Out for Delivery
• Delivered

Do I need to have a customer profile in Klaviyo before I receive tracking updates from Starshipit?

Yes. If you don't have a profile, Klaviyo will automatically create a user profile when an update is pushed through. However, this automatic profile will be treated as a non-subscriber, meaning they won't receive any notifications.

Troubleshooting

Why is 'Starshipit Tracking Status' not showing in my Klaviyo drop-down menu?

'Starshipit Tracking Status' will appear in your Klaviyo metric dropdown after the first event update from Starshipit to Klaviyo. To trigger this update, initiate the shipment of an order (e.g., print the shipping label) and the Starshipit Tracking Status should show in the metric dropdown. If you still encounter issues, contact our support team here for assistance.

What tracking information does Starshipit send to Klaviyo?

Starshipit transmits the following details:

• Tracking Status
• Order Number
• Carrier
• Tracking Number
• Tracking URL

My customers aren't receiving emails. What could be causing this?

Several factors could cause this situation:

• Your API key does not match.
• The customer's profile might not be subscribed to emails.
• Smart sending could be enabled. You can find more details in the Klaviyo Help Center.