Update a Pass from a Klaviyo Flow

Overview

Once a customer has a pass, you can update its content whenever their Klaviyo profile changes — points earned, tier upgraded, reward redeemed, expiry extended. The update call uses the pass serial number stored on the profile by PassNinja after the pass was created.

Prerequisites

You will need:

Method 1: Webhook Action (No Code)

Step 1 — Guard against profiles without a pass

Before the Webhook action, add a Profile Property condition:

• external_id is set

This prevents the webhook from firing for profiles that haven't been issued a pass yet.

Step 2 — Configure the request

Replace ptk_0x4d5e6f with your actual template ID.

Step 3 — Add headers

Step 4 — Set the request body

{
  "pass": {
    "points-balance": "{{ person.properties.loyalty_points|default:0 }}",
    "loyalty-tier": "{{ person.properties.loyalty_tier|default:'Standard' }}"
  }
}

Only include the fields you want to change. Fields not listed in the body are left as-is on the pass.

Suggested triggers

Method 2: Code Block

Step 1 — Set up environment variables

In the Code action's Environment Variables tab, add:

Step 2 — Write the code

export const handler = async (event, profile, context) => {
  const attrs = profile.data.attributes;
  const serial = attrs.external_id;

  if (!serial) {
    return { skipped: true, reason: 'no active pass' };
  }

  const response = await fetch(
    `https://api.passninja.com/v1/passes/${process.env.PASSNINJA_TEMPLATE_ID}/${serial}`,
    {
      method: 'PATCH',
      headers: {
        'X-API-KEY': process.env.PASSNINJA_API_KEY,
        'X-ACCOUNT-ID': process.env.PASSNINJA_ACCOUNT_ID,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        pass: {
          'points-balance': String(attrs.properties?.loyalty_points ?? 0),
          'loyalty-tier': attrs.properties?.loyalty_tier ?? 'Standard',
        },
      }),
    }
  );

  if (!response.ok) {
    const error = await response.json();
    throw new Error(`PassNinja error: ${JSON.stringify(error)}`);
  }

  return { updated: true };
};

Replace the keys inside pass with the api_field_name values you want to update — find these in PassNinja → Pass Templates → Fields.

Suggested triggers

Troubleshooting

Update fails with 404

The serial stored as external_id may belong to a pass that was already deleted.

• Webhook: Check the external_id is set condition before the action
• Code block: The if (!serial) guard already handles this — it returns skipped instead of throwing

Pass not refreshing in wallet

PassNinja sends an APN/FCM push notification to the device after every update. If the wallet doesn't refresh:

1. Confirm the update returned a 2xx response in Klaviyo's activity log or Code output
2. Check that the device has an active internet connection
3. Apple Wallet refreshes may take a few seconds

Support

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