Delete a Pass from a Klaviyo Flow

Overview

Use a delete flow to revoke a customer's pass when they churn, unsubscribe globally, or their membership lapses. The delete call uses the pass serial number stored on the Klaviyo profile. After the delete, PassNinja fires a Pass Deleted event back to Klaviyo which clears the pass properties from the profile automatically.

This is permanent. A deleted pass cannot be restored — the customer must be issued a new pass if they rejoin.

Prerequisites

You will need:

Method 1: Webhook Action (No Code)

Step 1 — Configure the request

Replace ptk_0x4d5e6f with your actual template ID.

No request body is needed for a delete.

Step 2 — Add headers

Step 3 — Guard against profiles without a pass

Add a Profile Property condition before the Webhook action:

• external_id is set

This prevents the webhook from firing for profiles that don't have a 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 pass found' };
  }

  const response = await fetch(
    `https://api.passninja.com/v1/passes/${process.env.PASSNINJA_TEMPLATE_ID}/${serial}`,
    {
      method: 'DELETE',
      headers: {
        'X-API-KEY': process.env.PASSNINJA_API_KEY,
        'X-ACCOUNT-ID': process.env.PASSNINJA_ACCOUNT_ID,
      },
    }
  );

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

  return { deleted: true };
};

Suggested triggers

What happens after deletion

PassNinja fires a Pass Deleted event to Klaviyo after the delete completes. The WalletPass Application Object record for this pass is updated automatically:

The external_id on the profile remains set to the serial — the profile is not deleted from Klaviyo. Any subsequent flow actions guarded by external_id is set will correctly skip the profile if you remove the external_id manually, or you can use the WalletPass object's status = deleted condition to filter.

Troubleshooting

Delete fails with 404

The serial in external_id may belong to a pass that was already deleted. The Code block's if (!serial) guard handles this gracefully. For the Webhook action, add the external_id is set condition before the action.

Pass still appears in the customer's wallet after deletion

Apple Wallet and Google Wallet remove the pass automatically when they next sync. This may take a few minutes depending on the device's connection. The pass cannot be used after deletion even if it's still visually present.

Support

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