Overview
Once a workflow trigger fires and conditions are satisfied, Workflow Execution Engine executes one or more automated operations defined in workflow action type (25 actions across pass mutations, tagging, messaging, logic, CRM, and analytics). In parallel, commerce and PassFlow automations (/automations and /api/v1/automations) execute 22 UniversalAutomationActionType operations governed by ExistingCardPolicy and ConflictResolutionPolicy.
Important: Automated pass mutations (
UPDATE_PASS,UPDATE_PASS_FIELDS,SWITCH_WALLET_EXPERIENCE,VOID_PASS,REACTIVATE_PASS) automatically sign updated.pkpassarchives (using the template's Apple Pass Type CertificatebundleId) and dispatch silent APNs and Google Wallet updates to all registered devices for that passholder.
Automated Action Execution Flow
Complete workflow action type Catalog (25 Actions)
1. Pass & Wallet Experience Mutations
| workflow action type | Operation Behavior | Typical Automation Scenario |
|---|---|---|
CREATE_PASS | Issues a pass record for a target templateId mapped from trigger attributes or externalId. | Create a membership card when an inbound WEBHOOK_RECEIVED event arrives from Typeform or HubSpot. |
UPDATE_PASS | Updates core pass properties (expirationDate, barcodeValue, externalId, status). | Extend expirationDate by 365 days when PAYMENT_RECEIVED occurs. |
DELETE_PASS | Soft-deletes a pass record from the active workspace inventory. | Clean up unactivated temporary guest passes after a retention window. |
UPDATE_PASS_FIELDS | Updates one or more custom key-value attributes on the pass face or back fields. | Update nextEventDate or promoBanner across passes when a milestone is reached. |
VOID_PASS | Transitions pass status to VOIDED and greys out the card in Apple and Google Wallet. | Automatically void an unpaid reservation pass if payment is not confirmed within 48 hours. |
REACTIVATE_PASS | Restores a previously VOIDED or INACTIVE pass back to ACTIVE status. | Re-enable a seasonal ski or gym pass when a member restarts their subscription. |
SWITCH_WALLET_EXPERIENCE | Morphs an installed pass in-place to a new template layout or Wallet Experience stage. | Transform an Event Registration Ticket into a Post-Event VIP Loyalty Card the morning after the concert. |
GENERATE_ADDITIONAL_PASS | Issues a linked companion pass (such as a single-use reward coupon) tied to the parent passholder. | Issue a Free Birthday Pastry Voucher when a loyalty card reaches 10 stamps. |
2. Segmentation, Logic & Analytics Actions
| workflow action type | Allowed Enum Values | Purpose |
|---|---|---|
| Audience Segmentation | ADD_TAG, REMOVE_TAG, MOVE_TO_SEGMENT | Tag passes (e.g., "checked-in") or enroll holders into dynamic broadcast segments. |
| Control Flow & Data | IF_CONDITION, DELAY, UPDATE_FIELD, CALCULATE_VALUE | Branch execution, wait inside Bull queues (delay), mutate fields, or compute derived values. |
| Analytics & CRM Sync | UPDATE_CRM_CONTACT, CREATE_CRM_LEAD, TRACK_EVENT, UPDATE_ANALYTICS | Push conversion events to CRMs and custom telemetry counters. |
3. Multi-Channel Communications & External Callbacks
| workflow action type | Operation Behavior | Typical Automation Scenario |
|---|---|---|
SEND_PUSH_NOTIFICATION | Sends a native lock-screen push notification to all devices registered for the pass. | Alert passholders 2 hours before expirationDate that their voucher is expiring soon. |
SEND_EMAIL | Sends a transactional email containing the smart download link (/s/:token). | Email a backup download link if PASS_CREATED is not followed by PASS_INSTALLED within 24 hours. |
SEND_SMS | Dispatches an SMS message via configured gateway with the pass short-link. | Deliver an instant mobile voucher link right after a POS check-in. |
WEBHOOK / HTTP_REQUEST / SLACK_MESSAGE | Sends an outbound signed HTTP request (POST, PUT, PATCH) or Slack alert. | Notify an external ERP, warehouse fulfillment system, or #ops Slack channel. |
Universal Automation Actions (/api/v1/automations)
For store checkout and loyalty rules configured in Automations (/automations), UniversalAutomationActionType provides 22 specialized commerce operations:
-
Card Lifecycle:
ASSIGN_OR_UPDATE_CARD,CREATE_NEW_CARD,UPGRADE_MEMBERSHIP_TIER,ISSUE_COUPON,ISSUE_GIFT_CARD,UPDATE_PASS_STATUS,EXTEND_EXPIRATION. -
Balances & Attributes:
ADD_POINTS,DEDUCT_POINTS,APPLY_STAMP,RESET_STAMPS,UNLOCK_REWARD,UPDATE_PREPAID_BALANCE,UPDATE_PASS_ATTRIBUTE,INCREMENT_PASS_ATTRIBUTE,DECREMENT_PASS_ATTRIBUTE. -
Storefront & Delivery:
APPLY_CART_OFFER,ACTIVATE_BENEFIT,SHOW_STOREFRONT_CTA,SEND_DELIVERY_NOTIFICATION,TRIGGER_WALLET_UPDATE,SCHEDULE_FOLLOW_UP.
End-to-End Blueprint: Event Ticket Morphing into Loyalty Card (POST /api/v1/workflows)
A signature capability of Passinstance is morphing an already-installed wallet pass into a new experience (SWITCH_WALLET_EXPERIENCE) using request payload:
{
"name": "Morph Festival Ticket to Alumni Loyalty Pass",
"trigger": {
"type": "SCHEDULED",
"schedule": {
"cron": "0 10 18 11 *"
},
"filters": {
"templateId": "tmpl_festival_2026_ticket"
}
},
"conditions": {
"field": "pass.tags",
"operator": "CONTAINS",
"value": "checked-in"
},
"actions": [
{
"type": "SWITCH_WALLET_EXPERIENCE",
"name": "Switch to Alumni Card",
"config": {
"targetTemplateId": "tmpl_festival_alumni_club",
"preserveSerialNumber": true,
"changeMessage": "Thanks for attending! Your ticket is now an Alumni Club Pass (%@)."
}
},
{
"type": "ADD_TAG",
"name": "Tag Alumni 2026",
"config": {
"tag": "alumni-2026"
}
}
]
}
Learn more about configuring triggers in Workflow Configuration and multi-card linking in Projects & Pass Bundling.
