# Passcreator

Passcreator is a SaaS platform that enables businesses to create, distribute, and manage digital Wallet passes for Apple Wallet and Google Wallet, including store cards, event tickets, coupons, and membership cards.

- **Category:** event management
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 11
- **Triggers:** 0
- **Slug:** `PASSCREATOR`
- **Version:** 20260223_00

## Tools

### Check Pass Existence

**Slug:** `PASSCREATOR_CHECK_PASS_EXISTENCE`

Tool to check if a pass exists for a given ID. Use when verifying pass existence before subsequent operations like updates or deletions. The ID can be a generatedId (unique ID created for every pass, usually encoded in the barcode), userProvidedId (optional custom ID), or any other identifier associated with a pass.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `passId` | string | Yes | The pass identifier to check for existence. Can be a generatedId, userProvidedId, or any ID associated with a pass. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create App Scan

**Slug:** `PASSCREATOR_CREATE_APP_SCAN`

Tool to create a new App Scan in PassCreator. Use when recording pass validation or attendance scanning events. Supports tracking scan status, device information, and optional pass voiding.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `passId` | string | No | The pass identifier, or null if no pass was found |
| `createdOn` | string | Yes | Timestamp in format YYYY-MM-DD HH:MM:SS |
| `setVoided` | boolean | No | Whether to mark the pass as invalid after scanning. Optional field. |
| `deviceName` | string | Yes | The device name performing the scan |
| `scanStatus` | string ("pass_voided_after_scan" | "pass_already_voided" | "attendance_saved" | "pass_not_found") | Yes | Status indicator: pass_voided_after_scan (0), pass_already_voided (1), attendance_saved (2), or pass_not_found (3) |
| `appConfigurationId` | string | Yes | The unique ID of the App Configuration tied to this scan (UUID format) |
| `scannedBarcodeValue` | string | Yes | The barcode value that was scanned |
| `additionalProperties` | object | No | Key-value pairs where keys are property IDs and values are the corresponding data. Optional field. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get App Configuration

**Slug:** `PASSCREATOR_GET_APP_CONFIGURATION`

Retrieves detailed information about an App Configuration by its identifier. Use when you need to get scan settings, UI customization, or validation rules for a specific App Configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identifier` | string | Yes | App Configuration identifier (UUID format, e.g., d0a467cf-391a-4b89-a00e-dc57a56d7b7b). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Process Status

**Slug:** `PASSCREATOR_GET_PROCESS_STATUS`

Get the current status and progress of a bulk operation including any errors. Use this to monitor long-running bulk operations like batch pass updates or creations. The identifier is returned when initiating a bulk operation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identifier` | string | Yes | The unique identifier (UUID) of the bulk operation process to check status for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Signing Public Key

**Slug:** `PASSCREATOR_GET_SIGNING_PUBLIC_KEY`

Tool to obtain the public key needed to verify signatures from the placeholder sign() function. Use when you need to verify cryptographic signatures generated by Passcreator's sign placeholder.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List App Configurations

**Slug:** `PASSCREATOR_LIST_APP_CONFIGURATIONS`

Retrieves all App Configurations for your Passcreator account. Use this action to get a list of validation configurations that control how passes are scanned and validated. Each configuration can be linked to specific pass templates or validate all passes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List App Scans

**Slug:** `PASSCREATOR_LIST_APP_SCANS`

Retrieves a paginated list of scans for a given app configuration. Use this tool to view scan history, track attendance, and analyze scan data ordered by creation date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `start` | integer | No | Pagination offset - the starting index for results (default: 0). |
| `pageSize` | integer | No | Number of results per page (default: 100, max: 100). |
| `createdSince` | string | No | Filter scans created after this datetime. Format: Y-m-d H:i (e.g., '2024-01-15 14:30'). |
| `appConfigurationId` | string | Yes | App Configuration identifier (UUID format) to retrieve scans for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List/Search Passes

**Slug:** `PASSCREATOR_LIST_PASSES`

List and search wallet passes from Passcreator using the v3 API. Use this tool to: - Retrieve all passes in your account - Filter passes by template ID or project ID - Search passes using a search phrase across all data fields - Paginate through large result sets Returns passes with metadata including identifiers, serial numbers, template info, and voided/redeemed status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pageSize` | integer | No | Number of passes to return per page (10-1000, default 100). |
| `projectId` | string | No | Filter passes by project ID (UUID format). Only return passes belonging to this project. |
| `templateId` | string | No | Filter passes by pass template ID (UUID format). Only return passes created from this template. |
| `searchPhrase` | string | No | Wildcard search phrase to match across all pass data fields. Use for general text searching. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Pass Templates

**Slug:** `PASSCREATOR_LIST_PASS_TEMPLATES`

Retrieves all pass templates for your Passcreator account. Use this action to get a list of available templates (each with its unique identifier and name) which are needed to create new passes. Templates must be created via the Passcreator web app.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Bulk Push Notifications

**Slug:** `PASSCREATOR_SEND_BULK_PUSH_NOTIFICATIONS`

Tool to send push notifications to multiple wallet passes simultaneously (up to 500 passes). Use when you need to notify pass holders about updates, events, or important information. The notification text can include personalization placeholders like {Firstname}.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `listOfPasses` | array | Yes | An array of pass identifiers (UID, userProvidedId, or barcode value). Maximum 500 identifiers per request. |
| `pushNotificationText` | string | Yes | The text for the push notification. May include placeholders like {Firstname} for personalization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Update Passes

**Slug:** `PASSCREATOR_UPDATE_PASSES_BULK`

Tool to bulk update multiple wallet passes using filter criteria. Returns immediately with a tracking URL to monitor the asynchronous bulk operation progress. Use when updating many passes at once with the same data changes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Object containing the fields to update on all matched passes. Replaces existing data for the specified fields. Common fields include: void (bool), expiry (string), custom field values, etc. |
| `filter` | object | Yes | Filter criteria to select which passes to update. Must specify at least one of: identifiers, segmentId, or query. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |