Form Submitted

WEBHOOK

formSubmitted

{
  "data": {
    "id": "a3cedd77-7be3-40f2-8b98-66b01a507de5",
    "type": "webhook",
    "attributes": {
      "webhookType": "formSubmitted",
      "timeStamp": "2026-10-29T14:18:11Z",
      "form": {
        "slug": "coffee-club-sign-up",
        "templateId": "8482506219bdf480a4a197ef"
      },
      "answers": [
        {
          "id": "fullName",
          "label": "Full name",
          "value": "Jane Smith",
          "nonPassField": false
        },
        {
          "id": "email",
          "label": "Email",
          "value": "[email protected]",
          "nonPassField": false
        },
        {
          "id": "birthday",
          "label": "Birthday",
          "value": "1992-04-18",
          "nonPassField": false
        },
        {
          "id": "phone",
          "label": "Phone number",
          "value": null,
          "nonPassField": false
        },
        {
          "id": "heardAboutUs",
          "label": "How did you hear about us?",
          "value": "Instagram",
          "nonPassField": true
        }
      ],
      "consents": [
        {
          "purpose": "data_processing",
          "type": "checkbox",
          "given": true,
          "text": "I agree to the Terms and Privacy Policy."
        }
      ]
    },
    "relationships": {
      "pass": {
        "data": {
          "id": "691abcf69b463774d94058eca84bc2e28a6ba889",
          "type": "pass"
        }
      }
    }
  },
  "included": [
    {
      "id": "691abcf69b463774d94058eca84bc2e28a6ba889",
      "type": "pass",
      "attributes": {
        "downloadUrl": "https://download.passentry.com/download?pass=691abcf69b463774d94058eca84bc2e28a6ba889",
        "passType": "storeCard",
        "createdAt": "2026-10-29T14:18:11Z",
        "status": "issued",
        "extId": "[email protected]",
        "groupTags": [],
        "passTemplateUuid": "8482506219bdf480a4a197ef",
        "passTemplateName": "Coffee Club",
        "nfc": null,
        "barcode": {
          "enabled": true,
          "type": "qr",
          "source": "uuid",
          "value": "691abcf69b463774d94058eca84bc2e28a6ba889",
          "displayText": false
        },
        "passContent": {
          "fullName": "Jane Smith",
          "email": "[email protected]",
          "birthday": "18/04/1992"
        }
      }
    }
  ]
}

{
  "status": "ok"
}

New to pass issuance forms? See the Custom Pass Issuance Forms guide.

Sent when someone submits a pass form and their pass is created. If the submission fails (for example, a duplicate external ID or the pass limit is reached), nothing is sent.

Answers – every field on the form, in the order shown. Dates are always in ISO8601 format (YYYY-MM-DD). The pass in included shows values as saved on the pass, so dates there use the date format chosen on the form field.
Non-pass fields – answers with nonPassField: true aren’t saved on the pass. This webhook is the only place you get them.
Consents – a copy of the consent text the person saw. checkbox means they ticked the box to agree, notice means the text was shown without a checkbox.
Telling forms apart – use form.templateId. The form slug can be changed in the dashboard.
Answers are not stored – PassEntry doesn’t keep form answers after the webhook is delivered. If your endpoint keeps failing until the last retry, the answers can’t be sent again.

Authorizations

X-Webhook-Signature

string

header

required

The X-Webhook-Signature header is generated using the webhook payload and shared secret key. To verify that the webhook is authentic, you can encrypt the webhook payload using the SHA-256 encryption algorithm and your secret key. If your generated signature matches the signature included in the X-Webhook-Signature header, you can confirm that the webhook is authentic.

Body

application/json

data

object

Show child attributes

included

object[]

The created pass. passContent shows the values as saved on the pass, so dates use the date format chosen on the form field.

Show child attributes

Response

200 - application/json

Return a 200 status to indicate that the data was received successfully

⌘I

{
  "data": {
    "id": "a3cedd77-7be3-40f2-8b98-66b01a507de5",
    "type": "webhook",
    "attributes": {
      "webhookType": "formSubmitted",
      "timeStamp": "2026-10-29T14:18:11Z",
      "form": {
        "slug": "coffee-club-sign-up",
        "templateId": "8482506219bdf480a4a197ef"
      },
      "answers": [
        {
          "id": "fullName",
          "label": "Full name",
          "value": "Jane Smith",
          "nonPassField": false
        },
        {
          "id": "email",
          "label": "Email",
          "value": "[email protected]",
          "nonPassField": false
        },
        {
          "id": "birthday",
          "label": "Birthday",
          "value": "1992-04-18",
          "nonPassField": false
        },
        {
          "id": "phone",
          "label": "Phone number",
          "value": null,
          "nonPassField": false
        },
        {
          "id": "heardAboutUs",
          "label": "How did you hear about us?",
          "value": "Instagram",
          "nonPassField": true
        }
      ],
      "consents": [
        {
          "purpose": "data_processing",
          "type": "checkbox",
          "given": true,
          "text": "I agree to the Terms and Privacy Policy."
        }
      ]
    },
    "relationships": {
      "pass": {
        "data": {
          "id": "691abcf69b463774d94058eca84bc2e28a6ba889",
          "type": "pass"
        }
      }
    }
  },
  "included": [
    {
      "id": "691abcf69b463774d94058eca84bc2e28a6ba889",
      "type": "pass",
      "attributes": {
        "downloadUrl": "https://download.passentry.com/download?pass=691abcf69b463774d94058eca84bc2e28a6ba889",
        "passType": "storeCard",
        "createdAt": "2026-10-29T14:18:11Z",
        "status": "issued",
        "extId": "[email protected]",
        "groupTags": [],
        "passTemplateUuid": "8482506219bdf480a4a197ef",
        "passTemplateName": "Coffee Club",
        "nfc": null,
        "barcode": {
          "enabled": true,
          "type": "qr",
          "source": "uuid",
          "value": "691abcf69b463774d94058eca84bc2e28a6ba889",
          "displayText": false
        },
        "passContent": {
          "fullName": "Jane Smith",
          "email": "[email protected]",
          "birthday": "18/04/1992"
        }
      }
    }
  ]
}

{
  "status": "ok"
}

Introduction

Entities

Pass Templates

Passes

Readers

Scans

Image Assets

Loyalty

Webhook Subscriptions

Webhooks

Batches

Authorizations

Body

Response