Create a Pass from a Klaviyo Flow Using a Webhook Action

Overview

Klaviyo's native Webhook flow action sends an HTTP POST directly to the PassNinja API. You configure the URL, headers, and request body in the Klaviyo UI — no code required. This is the fastest way to issue a pass from a Klaviyo flow when you don't need conditional logic.

Prerequisites

You will need three values from PassNinja:

Step 1 — Add a Webhook action to your flow

In Klaviyo's flow builder, click the + button at the point where you want the pass to be created, then choose Webhook.

Good trigger points:

• Subscribed to List — issue a welcome pass when someone joins
• Placed Order — issue a post-purchase loyalty pass
• Custom metric — issue a pass on loyalty enrollment or any business event

Step 2 — Configure the request

Step 3 — Add headers

Step 4 — Set the request body

{
  "passTemplate": "ptk_0x4d5e6f",
  "pass": {
    "member-name": "{{ person.first_name }} {{ person.last_name }}",
    "member-email": "{{ person.email }}",
    "phone-number": "{{ person.phone_number|default:'' }}"
  },
  "recipient": {
    "email": "{{ person.email }}",
    "name": "{{ person.first_name|default:'' }}"
  }
}

Replace ptk_0x4d5e6f with your actual template ID.

Replace the keys inside pass with the api_field_name values from your pass template — find these in PassNinja → Pass Templates → select your template → Fields.

Referencing custom Klaviyo profile properties

Use {{ person.properties.your_property_name|default:'' }} to map any custom profile property to a pass field:

{
  "passTemplate": "ptk_0x4d5e6f",
  "pass": {
    "member-name": "{{ person.first_name }} {{ person.last_name }}",
    "member-email": "{{ person.email }}",
    "loyalty-tier": "{{ person.properties.loyalty_tier|default:'Standard' }}",
    "points-balance": "{{ person.properties.loyalty_points|default:0 }}"
  },
  "recipient": {
    "email": "{{ person.email }}",
    "name": "{{ person.first_name|default:'' }}"
  }
}

Step 5 — Save and activate

Save the Webhook action and activate your flow. Klaviyo will send the request to PassNinja each time a profile reaches that step.

How the profile write-back works

After PassNinja creates the pass, it automatically fires a Pass Created event back to Klaviyo. The customer profile is created (or updated) with:

PassNinja also writes a WalletPass Application Object record in Klaviyo's Custom Objects, linked to the profile via external_id. This record tracks pass state (active, uninstalled, deleted), the download URL, platform, and timestamps.

To link directly to the customer's pass in any subsequent email or SMS, use:

https://passninja.com/p/{{ person.external_id }}

Troubleshooting

Webhook not firing or returning an error

Check the webhook delivery log: Klaviyo → Flows → select your flow → Activity. Look for non-2xx responses and read the response body — PassNinja returns a JSON error message describing the problem.

Common causes:

1. Wrong API key or account ID in the headers
2. Pass field keys don't match the api_field_name values in your template — check PassNinja → Pass Templates → Fields
3. A required field is missing or empty

external_id not set on the profile

1. Confirm the Klaviyo integration is connected in PassNinja → Integrations → Klaviyo
2. Allow a few seconds — the write-back fires asynchronously after pass creation
3. Search for the profile in Klaviyo using the pass serial number

Support

• Email: support@passninja.com
• API Reference: passninja.com/documentation
• All Klaviyo tutorials: passninja.com/tutorials/klaviyo