Documentation

Guides and tutorials for integrating PassEngine with your tools and workflow.

Zapier Integration

Connect PassEngine to 7,000+ apps with Zapier. Automate pass creation, notifications, and data syncing without writing code.

Overview

The PassEngine Zapier integration lets you automate workflows between PassEngine and thousands of other apps. Here's what you can do:

  • Automatically create passes when new orders come in from Shopify, Stripe, or WooCommerce
  • Send Slack or email notifications when a pass is scanned
  • Sync new clients to your CRM (HubSpot, Salesforce, etc.)
  • Log pass activity to Google Sheets or Airtable

Prerequisites

  • A PassEngine account on the Pro plan
  • An API key (created in Dashboard → API)
  • A Zapier account (free or paid)

Getting Your API Key

  1. Log in to your PassEngine dashboard
  2. Go to Settings → API
  3. Click "Create API Key" and give it a descriptive name
  4. Copy the key — you'll need it when connecting PassEngine in Zapier

Available Triggers

Triggers fire automatically when something happens in PassEngine. Use them to start a Zap.

EventDescriptionExample Use Case
pass.createdA new pass is createdSend a welcome email to the guest
pass.scannedA pass is scanned at entryPost a Slack message to the event channel
pass.status_changedPass status changes (active, used, expired, revoked)Update a Google Sheet row with the new status
client.createdA new client is addedCreate a contact in HubSpot

Available Actions

Actions let you control PassEngine from other apps. Use them as steps in your Zap.

ActionDescription
Create PassCreate a new single-use or multi-use pass with custom fields
Activate PassRe-activate a revoked pass
Revoke PassRevoke an active pass so it can no longer be scanned
Record ScanRecord a scan event for a pass

Setting Up a Zap

Here are two common workflows to get you started.

Example: New Stripe Payment → Create Pass

  1. In Zapier, create a new Zap and choose Stripe as the trigger app
  2. Select the "New Payment" trigger event
  3. Add PassEngine as the action app and select "Create Pass"
  4. Map the Stripe customer name and email to pass fields
  5. Test and turn on your Zap

Example: Pass Scanned → Slack Notification

  1. Create a new Zap with PassEngine as the trigger app
  2. Select "Pass Scanned" as the trigger event and connect your API key
  3. Add Slack as the action app and choose "Send Channel Message"
  4. Customize the message with pass and scanner details, then activate

Webhooks (Advanced)

For real-time integrations, PassEngine can push events directly to your endpoint via webhooks. Zapier uses this under the hood, but you can also subscribe manually.

Subscribe to an event

POST /api/v1/webhooks
Authorization: Bearer 2pk_your_api_key

{
  "event": "pass.created",
  "targetUrl": "https://hooks.zapier.com/hooks/catch/123/abc"
}

Webhook payload format

{
  "event": "pass.created",
  "timestamp": "2025-06-01T12:00:00.000Z",
  "data": {
    "id": "clx1abc...",
    "code": "AbCd1234EfGh",
    "name": "VIP Guest",
    "type": "single",
    "status": "active",
    "publicUrl": "https://app.passengine.io/p/AbCd1234EfGh?token=..."
  }
}

Signature verification

Every webhook request includes an HMAC-SHA256 signature in the X-PassEngine-Signature header. Verify this signature to ensure the payload was sent by PassEngine and hasn't been tampered with.

X-PassEngine-Signature: <HMAC-SHA256 hex digest>
X-2Pass-Event: pass.created

Delivery & reliability

  • Webhooks are retried up to 3 times with exponential backoff (1s, 30s, 5min)
  • Your endpoint must respond with a 2xx status within 30 seconds
  • After 5 consecutive delivery failures, the webhook is auto-disabled
  • Up to 10 webhooks per organization

Polling Fallback

If you prefer polling over webhooks (or as a fallback), use the triggers API endpoint. It returns recent events sorted by newest first.

GET /api/v1/triggers?event=pass.created&since=2025-06-01T00:00:00Z&limit=50
Authorization: Bearer 2pk_your_api_key

Rate Limits & Quotas

  • API requests: 30 per minute per API key
  • Webhooks: up to 10 subscriptions per organization
  • Polling: returns up to 100 items per request

See Also