The Klaviyo integration sends PDQ's shipping and delivery events to your customers' Klaviyo profiles as metrics, so your flows can react to what is actually happening to an order.
Connecting your API key is only the first half of the setup. A recipe is what tells PDQ which events to send, and nothing reaches Klaviyo until at least one recipe is active.
Before you begin
Admin access to your Klaviyo account so you can create a private API key
Access to PDQ Settings → Integrations
Room in your Klaviyo metrics list. Klaviyo limits how many metrics an account can hold, and PDQ adds up to 28. If you are close to that limit, remove unused metrics first or PDQ's events will not show up.
Step 1: Create a Klaviyo API key
In Klaviyo, go to Settings → API keys and create a private API key. Copy it somewhere safe, because Klaviyo only shows the full key once.
Step 2: Connect Klaviyo in PDQ
Log into PDQ and go to Settings → Integrations. Find Klaviyo in the list, click Connect, and paste in your API key.
A successful connection confirms PDQ can reach your Klaviyo account. It does not send anything yet.
Step 3: Add a recipe
Go to Settings → Integrations → Klaviyo → Recipe templates.
Find the template "If an order's shipping status updates to _____, then track the customer's Klaviyo profile with a metric" and click Add to your recipes.
In the recipe setup, pick the shipping status you want to track. To track orders on their way to the customer, for example, choose en route to customer. That fires the PDQ_Shipping_Event_IN_TRANSIT metric.
Add a separate recipe for every status you care about. Order placed, delivered, out for delivery, and late are the usual starting set.
Your active recipes appear in the Your recipes tab. If that tab is empty, PDQ is not sending anything to Klaviyo.
Step 4: Build the flow in Klaviyo
Once a recipe is active and an order reaches that status, the event lands in Klaviyo as a metric named PDQ_Shipping_Event_ plus the status, for example PDQ_Shipping_Event_DELIVERED.
In Klaviyo, create a flow and set the trigger to that metric. For the full list of what PDQ sends and what each event is good for, see PDQ shipping events in Klaviyo.
Good to know: a metric only appears in Klaviyo's trigger list after it has fired at least once. If you just switched a recipe on and cannot find the metric, wait for a real order to hit that status.
Troubleshooting
No events are showing up in Klaviyo
Check the Your recipes tab. An empty tab is the most common cause. The API key on its own sends nothing.
Confirm an order has actually reached the status your recipe is watching.
Events fire on some orders but not others
Check the conditions on the recipe. A recipe scoped to a subset of orders, gift orders for example, will only fire for those orders.
The metric is missing from Klaviyo's trigger dropdown
It has not fired yet. Metrics appear in Klaviyo only after the first event.
You may have hit Klaviyo's metric limit. Remove metrics you no longer use and check again.
That's it! And as always, don't hesitate to reach out to support@prettydamnquick.com if you have any questions.