Overview
Passinstance provides first-class integration surfaces for no-code automation platforms (Zapier, Make), e-commerce storefronts, CRM systems, payment processors, and marketing clouds, configured in Workspace Settings -> Integrations (/settings/workspace/integrations, /connectors, /connected-apps, and /link-generator). In addition to the /api/v1 REST API and outgoing webhooks, Passinstance exposes an OAuth/iPaaS discovery surface (Integrations API) and prefix-free inbound vendor webhook receivers (/webhooks/*).
Important: Inbound vendor webhook endpoints (
/webhooks/stripe,/webhooks/shopify, etc.) are explicitly excluded from the global/api/v1prefix inmain.tsso they match strict third-party vendor callback URL conventions and cryptographic signature verifiers out of the box.
Integration Connectivity Architecture
Zapier & Make OAuth Integration Surface (Integrations API)
Low-code automation builders connect to Passinstance via OAuth 2.0 Bearer tokens (OAuth 2.0 Authentication + Permission Scope Validation) under /api/v1:
| Method | Endpoint | Required OAuth Scope | Purpose in Zapier / Make |
|---|---|---|---|
| GET | /api/v1/me | Valid OAuth2 token | Verifies connection credentials and returns authenticated tenant and user context (Connected Integrations API). |
| GET | /api/v1/templates/:templateId/attributes | templates:read | Dynamically populates custom template fields (memberName, points, tier) inside the action designer. |
| POST | /api/v1/webhook-subscriptions | webhooks:write | Registers a webhook subscription ({ event, targetUrl, metadata? }) when a user turns on a Zap or scenario. |
GET / DELETE | /api/v1/webhook-subscriptions | webhooks:read / webhooks:write | Lists or removes OAuth-managed webhook subscriptions (/api/v1/oauth/connections for connected apps UI). |
Supported integration category Categories
When creating workspace integrations (/api/v1/integrations), Passinstance classifies connectors using the 21-value Passinstance database integration category: CRM, MARKETING_AUTOMATION, PAYMENT, TICKETING, GEOLOCATION, NOTIFICATIONS, ANALYTICS, INVENTORY, ACCOUNTING, CREATE_PASS_URL, FTP_JOB, IFRAME_PASS_DOWNLOAD, GOOGLE_ANALYTICS, NFC_PERSONALIZATION, PASS_DATA_FTP_UPLOAD, NAS_DATA_FTP_UPLOAD, FTP_IMPORT_JOB, FTP_EXPORT_JOB, EMBED_PASS_DOWNLOAD, WEB_ANALYTICS, and PARAMETERIZED_PASS_LINK.
Dedicated Inbound Vendor Webhook Routes (/webhooks/*)
Passinstance provides dedicated, signature-verified inbound webhook receivers for 10 major commerce, CRM, messaging, and event platforms (plus /v1/automations/webhooks/shopify/:customerId and /woocommerce/:customerId for multi-tenant storefront rule matching):
| Vendor Platform | Inbound Callback Route | Typical Trigger Events Handled | Automated Passinstance Action |
|---|---|---|---|
| Stripe | POST /webhooks/stripe & POST /webhooks/stripe/billing | checkout.session.completed, invoice.paid, customer.subscription.deleted | Issues paid membership passes (PassFlow webhook also at /api/v1/pass-flows/public/webhooks/stripe) or voids on cancellation. |
| Shopify | POST /webhooks/shopify | orders/paid, orders/cancelled, customers/create, refunds/create | Issues/upserts loyalty or gift cards (externalId) and voids refunded vouchers. |
| WooCommerce | POST /webhooks/woocommerce | order.completed, order.refunded, customer.created | Provisions store credit cards, updates loyalty points, and syncs order redemptions. |
| Salesforce | POST /webhooks/salesforce | Outbound Message / Platform Event (Contact, Opportunity, CampaignMember) | Issues VIP passes when deals close (X-Passinstance-Salesforce-Signature). |
| HubSpot | POST /webhooks/hubspot | contact.creation, contact.propertyChange, deal.propertyChange | Enrolls CRM contacts into Wallet Experiences and syncs tier changes. |
| Klaviyo | POST /webhooks/klaviyo | Flow Webhook Action (Segment entry, VIP milestone, birthday flow) | Generates personalized pass links or triggers lock-screen push notifications. |
| Twilio | POST /webhooks/twilio | SMS delivery status callbacks & inbound SMS keyword opt-ins | Tracks SMS pass delivery receipts and issues passes when customers text a keyword. |
| Eventbrite | POST /webhooks/eventbrite | order.placed, attendee.updated, attendee.checked_in | Issues Apple/Google Wallet event tickets (bundleId-signed .pkpass) and syncs gate check-in state. |
| Typeform | POST /webhooks/typeform | form_response submission webhook | Converts survey or lead-capture form submissions directly into personalized wallet passes. |
| Zoho CRM | POST /webhooks/zoho | Workflow rule webhook (Leads, Contacts, Deals) | Issues and updates member cards from Zoho CRM workflow transitions. |
Additional Native Connectivity Options
-
Shopware 6 Native Plugin: Full admin, storefront, registration, and webhook controller suite (/shopware and E-Commerce Integrations).
-
Scheduled FTP / SFTP Batch Sync: Automated nightly CSV import and export jobs (
FTP_IMPORT_JOB/FTP_EXPORT_JOB) for legacy ERP and retail POS systems. -
Dynamic Wallet URLs & Embed Widgets: Signed URL generation (
/settings/workspace/integrations/link-generator) and drop-in HTML buttons (EMBED_PASS_DOWNLOAD,IFRAME_PASS_DOWNLOAD).
Browse all connectors on /integrations and explore internal rule automation in Workflow Configuration.
