Skip to content
Help Center Guide · Workflows & Automation
4 min readVerified 2026-11-16

Automated Pass Operations

Automate post-install follow-up templates, scheduled tier/expiry updates, and auto-generated bundle passes without manual polling.

In This Guide

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 .pkpass archives (using the template's Apple Pass Type Certificate bundleId) and dispatch silent APNs and Google Wallet updates to all registered devices for that passholder.

Automated Action Execution Flow

SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
WORKFLOW ACTION EXECUTION & WALLET MORPHING
PARTICIPATING SYSTEM ACTORS
P1 Workflow Execution Engine
P2 Pass & Experience Services
P3 Customer Wallet Device
STEP 1a REQUEST / ACTION SWITCH_WALLET_EXPERIENCE
›
Rebind pass to new Template/Tier
STEP 2a REQUEST / ACTION Card Face Morphs Live
STEP 1b REQUEST / ACTION GENERATE_ADDITIONAL_PASS
›
Issue companion pass (externalId)|-- 2b. Deliver Bundle Link /
›
Push Notification
STEP 1c REQUEST / ACTION ADD_TAG / MOVE_TO_SEGMENT
›
Update audience membership
STEP 1d REQUEST / ACTION WEBHOOK / HTTP_REQUEST
›
Dispatch signed payload to CRM

Complete workflow action type Catalog (25 Actions)

1. Pass & Wallet Experience Mutations

workflow action typeOperation BehaviorTypical Automation Scenario
CREATE_PASSIssues 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_PASSUpdates core pass properties (expirationDate, barcodeValue, externalId, status).Extend expirationDate by 365 days when PAYMENT_RECEIVED occurs.
DELETE_PASSSoft-deletes a pass record from the active workspace inventory.Clean up unactivated temporary guest passes after a retention window.
UPDATE_PASS_FIELDSUpdates 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_PASSTransitions 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_PASSRestores 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_EXPERIENCEMorphs 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_PASSIssues 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 typeAllowed Enum ValuesPurpose
Audience SegmentationADD_TAG, REMOVE_TAG, MOVE_TO_SEGMENTTag passes (e.g., "checked-in") or enroll holders into dynamic broadcast segments.
Control Flow & DataIF_CONDITION, DELAY, UPDATE_FIELD, CALCULATE_VALUEBranch execution, wait inside Bull queues (delay), mutate fields, or compute derived values.
Analytics & CRM SyncUPDATE_CRM_CONTACT, CREATE_CRM_LEAD, TRACK_EVENT, UPDATE_ANALYTICSPush conversion events to CRMs and custom telemetry counters.

3. Multi-Channel Communications & External Callbacks

workflow action typeOperation BehaviorTypical Automation Scenario
SEND_PUSH_NOTIFICATIONSends 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_EMAILSends 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_SMSDispatches 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_MESSAGESends 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:

JSON
{
  "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.

Related Product & Developer Documentation

Ready to launch your first pass program?

Create your workspace, configure your pass template, and test a real pass in Apple Wallet and Google Wallet before you scale.