---
title: "A playbook person waits for a person"
method: POST
path: "playbook.person_waiting"
tags: ["Webhooks"]
---

# A playbook person waits for a person

`POST playbook.person_waiting` (webhook)

Sent to endpoints subscribed to `playbook.person_waiting` or `all`. Verify the signature as the Webhooks tag describes and deduplicate on the event ID.

## Headers

- `X-GTM-Swag-Event-Id` string, required
- `X-GTM-Swag-Signature` string, required

## Payload

- PlaybookPersonWaitingEvent: A playbook person left waiting for a person, sent once per new reason. Webhook only (not in GET /events).
  - `id` string, required: Event ID (32 hex); the X-GTM-Swag-Event-Id header.
  - `type` 'playbook.person_waiting', required
  - `timestamp` string, required
  - `campaignId` string, required: The playbook (cmp_).
  - `recipientId` string, required
  - `sourceSystem` string
  - `externalId` string
  - `reason` 'auto_approve_off' | 'over_gift_limit' | 'monthly_cap' | 'low_balance' | 'repeat_recipient' | 'photo_review' | 'age_restricted' | 'shipping_quote' | 'email_unverified' | 'blocked', required: Why the person waits for a person: auto_approve_off (no auto-approve on this playbook), over_gift_limit (the gift costs more than the per-gift limit), monthly_cap (the monthly budget is used up), low_balance (the balance cannot cover the gift; adding funds does not re-check waiting people), repeat_recipient (already gifted by another campaign), photo_review (a photo must be sourced or approved), age_restricted (alcohol always waits), shipping_quote (delivery is not priced yet, so these gifts always wait), email_unverified (the person who turned it on has not verified their email), blocked (anything else, such as an unavailable or unverified gift, or with mode live a person without a sender-supplied address).
  - `approvalUrl` string, required: Hand this to a person to approve.

## Acknowledgement `2XX`

Any 2xx acknowledges the delivery.

## Other responses

- `default`: Anything else (or no answer in 10 seconds) is retried.

---

[API](https://skmtc.dev/gtmswag/apis/gtm-swag-api.md) · [All operations](https://skmtc.dev/gtmswag/apis/gtm-swag-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gtmswag/apis/gtm-swag-api/revisions/9ff86fa99afe?raw)