{
  "info": {
    "name": "app2email WhatsApp API",
    "_postman_id": "a2e-whatsapp-api-v1",
    "description": "app2email WhatsApp API 1.4.0. Set the variables number (digits only) and api_key. Reference: https://www.app2email.com/docs/api",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{api_key}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://api.app2email.com",
      "type": "string"
    },
    {
      "key": "number",
      "value": "YOUR_NUMBER",
      "type": "string"
    },
    {
      "key": "api_key",
      "value": "YOUR_API_KEY",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Messages",
      "description": "Send WhatsApp messages (templates and free-form replies), read them and look up their status.",
      "item": [
        {
          "name": "Messages sent and received, newest first",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/messages?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "messages"
              ],
              "query": [
                {
                  "key": "since",
                  "value": "2026-10-25T10:00:00Z",
                  "description": "Only messages at or after this time. ISO 8601, eg 2026-10-25T10:00:00Z.",
                  "disabled": true
                },
                {
                  "key": "until",
                  "value": "2026-10-26T00:00:00Z",
                  "description": "Only messages before this time. ISO 8601.",
                  "disabled": true
                },
                {
                  "key": "direction",
                  "value": "in",
                  "description": "in: received. out: sent. Left out: both.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "queued",
                  "description": "Sent messages only: queued, accepted, sent, delivered, read or failed. Not with direction=in.",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "61412345678",
                  "description": "Only with this contact (full number, digits, with country code).",
                  "disabled": true
                },
                {
                  "key": "broadcast",
                  "value": "k3XbQ9rTzP2mWv7a1c9e",
                  "description": "Only the messages of this broadcast (its code).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "Messages sent from the number (`direction` out, with their status and times) and received from contacts (`direction` in). Filters: a time window, the direction, the status of sent messages, one contact, or one broadcast. Page with `next_cursor`.\n\nhttps://www.app2email.com/docs/api/messages/list-messages"
          },
          "response": []
        },
        {
          "name": "Send a WhatsApp message: template, or free-form reply",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/messages",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "messages"
              ]
            },
            "description": "Sends one approved template to one recipient, or to several when `to` lists several numbers (or `recipients` gives each number its own values). The parameters are checked against the template before sending; on a mismatch the error includes a complete, correct `example_request` for that template. Nothing is sent when the request itself is invalid. `dry_run` checks without sending; `background` answers 202 and sends after; `send_at` schedules it (202, status scheduled). `type` text, image, video, document or interactive sends a free-form message to one contact within 24 hours of the contact's last message (422 outside_24h_window otherwise). `segment` sends a template to a saved segment's contacts. A business-scoped user id works wherever a number does. Also `audio`, `sticker`, `location`, `contacts`, `reaction` and the newer interactive kinds; template carousels, limited-time offers, catalog, MPM, SPM, flow and OTP buttons. `callback_data` comes back in message.status. MARKETING templates follow `marketing_api` / messages.marketing_route (`sent_via` in the answer).\n\nhttps://www.app2email.com/docs/api/messages/send-template-message",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"to\": \"61412345678\",\n  \"type\": \"template\",\n  \"template\": {\n    \"name\": \"order_update\",\n    \"language\": {\n      \"code\": \"en\"\n    },\n    \"components\": [\n      {\n        \"type\": \"body\",\n        \"parameters\": [\n          {\n            \"type\": \"text\",\n            \"text\": \"John\"\n          },\n          {\n            \"type\": \"text\",\n            \"text\": \"#1234\"\n          }\n        ]\n      }\n    ]\n  },\n  \"dry_run\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Status of a sent message",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/messages/:message_id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "messages",
                ":message_id"
              ],
              "variable": [
                {
                  "key": "message_id",
                  "value": "wamid.HBgLNjE0MTIzNDU2NzgVAgARGBJTQU1QTEVfVEVTVF9FVkVOVAA=",
                  "description": "The message_id from the send answer (starts with 'wamid.'). URL-encode it."
                }
              ]
            },
            "description": "Any message sent from the number (API, Broadcast page, email replies): status, the time of each step, why it failed, and the contact's reply or button tap.\n\nhttps://www.app2email.com/docs/api/messages/get-message-status"
          },
          "response": []
        },
        {
          "name": "Mark a received message as read, optionally typing",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/messages/read",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "messages",
                "read"
              ]
            },
            "description": "Blue ticks on a message the contact sent (and the earlier ones of the chat), up to 30 days old; `typing` also shows the typing indicator for up to 25 seconds. Free: not counted, no 24 hour window. Meta's own body on POST /messages works too.\n\nhttps://www.app2email.com/docs/api/messages/mark-message-read",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"message_id\": \"wamid.HBgLNjE0MTIzNDU2NzgVAgASGBQzQUZCMTY0MDc2MUYwNzBDNTY5MAA=\",\n  \"typing\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Where marketing templates go: Cloud API or Marketing Messages API",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/marketing?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "marketing"
              ],
              "query": [
                {
                  "key": "refresh",
                  "value": "",
                  "description": "true: ask WhatsApp now.",
                  "disabled": true
                }
              ]
            },
            "description": "The route setting (messages.marketing_route), the route a marketing template takes now, WhatsApp's onboarding status and the account's Cloud API switch. `?refresh=true` asks WhatsApp now (otherwise up to 1 hour old).\n\nhttps://www.app2email.com/docs/api/messages/get-marketing-status"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Media",
      "description": "Upload files for sends; download the files contacts sent.",
      "item": [
        {
          "name": "Upload a file once, get a media id",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/media",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "media"
              ]
            },
            "description": "Uploads an image, video, document, audio file or sticker to WhatsApp and returns a `media_id` for `{\"id\": ...}` in later sends (templates or free-form). WhatsApp keeps it 30 days. JSON (a link or base64 data) or multipart/form-data (`file`, optional `type`). Limits: image JPEG/PNG 5 MB, video MP4/3GP 16 MB, audio 16 MB, sticker WebP 100 KB static / 500 KB animated, document 100 MB. A sandbox key checks the file and uploads nothing.\n\nhttps://www.app2email.com/docs/api/media/upload-media",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"image\",\n  \"file\": {\n    \"link\": \"https://example.com/photo.jpg\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Download a received file (stored copy, else from WhatsApp)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/media/:id?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "media",
                ":id"
              ],
              "query": [
                {
                  "key": "info",
                  "value": "",
                  "description": "true: the file's type, size and sha256 as JSON, not the file.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wamid.HBgLNjE0MTIzNDU2NzgVAgARGBJTQU1QTEVfVEVTVF9FVkVOVAA=",
                  "description": "The message_id of a received message (wamid..., URL-encoded), or a WhatsApp media id (digits)."
                }
              ]
            },
            "description": "app2email keeps its own copy of every received image, video, audio, document and sticker (WhatsApp's ids expire after 7 days): served first. Without one, the file comes from WhatsApp by the message's media id, or by a WhatsApp media id in the URL. Header X-Media-Source: stored | whatsapp. `?info=true`: type, size and sha256 instead of the file. WhatsApp pauses media lookups after many errors, so an id it did not know is remembered for 30 minutes.\n\nhttps://www.app2email.com/docs/api/media/get-media"
          },
          "response": []
        },
        {
          "name": "Delete an uploaded file at WhatsApp",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/media/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "media",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "1037543291543636",
                  "description": "The WhatsApp media id (digits)."
                }
              ]
            },
            "description": "The media_id of POST /media (WhatsApp keeps uploads 30 days otherwise). A scheduled send that still uses it then fails. app2email's stored copies of received files stay.\n\nhttps://www.app2email.com/docs/api/media/delete-media"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Conversations",
      "description": "One thread per contact: the 24 hour window, its messages and its owner (handoff).",
      "item": [
        {
          "name": "The contacts, most recent activity first",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/conversations?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "conversations"
              ],
              "query": [
                {
                  "key": "since",
                  "value": "",
                  "description": "Only contacts active at or after this time. ISO 8601.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "One entry per contact, with the last message in each direction and whether a free-form reply can be sent now (window_open).\n\nhttps://www.app2email.com/docs/api/conversations/list-conversations"
          },
          "response": []
        },
        {
          "name": "One contact's messages, both directions",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/conversations/:phone/messages?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "conversations",
                ":phone",
                "messages"
              ],
              "query": [
                {
                  "key": "since",
                  "value": "",
                  "description": "At or after this time. ISO 8601.",
                  "disabled": true
                },
                {
                  "key": "until",
                  "value": "",
                  "description": "Before this time. ISO 8601.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "phone",
                  "value": "61412345678",
                  "description": "The contact's number, with country code, or their business-scoped user id."
                }
              ]
            },
            "description": "The messages with one contact, newest first. window_open says whether a free-form reply can be sent now.\n\nhttps://www.app2email.com/docs/api/conversations/list-conversation-messages"
          },
          "response": []
        },
        {
          "name": "One contact: window state, last messages, owner",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/conversations/:contact",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "conversations",
                ":contact"
              ],
              "variable": [
                {
                  "key": "contact",
                  "value": "61412345678",
                  "description": "The contact's number (country code first), or their business-scoped user id."
                }
              ]
            },
            "description": "The conversation with one contact: `window_state` open or closed and `window_closes_at`, the last message each way, held email replies, and who owns it (see PUT .../owner).\n\nhttps://www.app2email.com/docs/api/conversations/get-conversation"
          },
          "response": []
        },
        {
          "name": "Hand a contact over: human, agent, paused, or back to normal",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/conversations/:contact/owner",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "conversations",
                ":contact",
                "owner"
              ],
              "variable": [
                {
                  "key": "contact",
                  "value": "61412345678",
                  "description": "The contact's number (country code first), or their business-scoped user id."
                }
              ]
            },
            "description": "Needs the 'messages:send' scope. `human` or `paused`: app2email's auto reply and the A2A / OpenClaw agent leave the contact alone (while the number's setting a2a.respect_owner is on); email forwarding carries on. `agent`: an automation owns it (a marker for everyone else). `\"\"`: the normal routing. `until_minutes` makes it temporary. Fires the conversation.owner_changed webhook event. A number that has never been in touch gets a conversation record so the owner can be set first.\n\nhttps://www.app2email.com/docs/api/conversations/set-conversation-owner",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"owner\": \"human\",\n  \"reason\": \"customer asked for a person\",\n  \"summary\": \"Wants to move the delivery to Monday.\",\n  \"until_minutes\": 240\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Templates",
      "description": "Your WhatsApp templates: list, create, look up, delete.",
      "item": [
        {
          "name": "List your templates, with an example request for each",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/templates",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "templates"
              ]
            },
            "description": "All templates of the number's WhatsApp account: status, category, what values each needs, and for approved templates a complete example request.\n\nhttps://www.app2email.com/docs/api/templates/list-templates"
          },
          "response": []
        },
        {
          "name": "Create a template and submit it for approval",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/templates",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "templates"
              ]
            },
            "description": "Needs the 'templates:manage' scope. The template goes to WhatsApp for review (minutes to a day). `template.status_changed` tells the result. Every Meta field is passed on (TTL, link tracking, max price, Template Library). WABA-wide: every number on this WhatsApp Business Account uses the same templates.\n\nhttps://www.app2email.com/docs/api/templates/create-template",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"order_update\",\n  \"language\": \"en\",\n  \"category\": \"UTILITY\",\n  \"components\": [\n    {\n      \"type\": \"BODY\",\n      \"text\": \"Hi {{1}}, your order {{2}} has shipped.\",\n      \"example\": {\n        \"body_text\": [\n          [\n            \"John\",\n            \"#1234\"\n          ]\n        ]\n      }\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "One template: status, rejection reason, what it needs",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/templates/:name",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "templates",
                ":name"
              ],
              "variable": [
                {
                  "key": "name",
                  "value": "order_update",
                  "description": "The template's name."
                }
              ]
            },
            "description": "Every language of the template. Not from a cache: a status that just changed shows. With every field Meta keeps (sub_category, previous_category, TTL, link tracking, library name).\n\nhttps://www.app2email.com/docs/api/templates/get-template"
          },
          "response": []
        },
        {
          "name": "Edit a template (components, category, TTL, max price)",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/templates/:name?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "templates",
                ":name"
              ],
              "query": [
                {
                  "key": "language",
                  "value": "en",
                  "description": "The template's language (eg en, en_US). Needed when the template has several.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "name",
                  "value": "order_update",
                  "description": "The template's name."
                }
              ]
            },
            "description": "Needs 'templates:manage'. Only APPROVED, REJECTED or PAUSED templates; an approved one at most once a day, 10 times in 30 days. WABA-wide: every number on this WhatsApp Business Account uses the same templates.\n\nhttps://www.app2email.com/docs/api/templates/edit-template",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"components\": [\n    {\n      \"type\": \"BODY\",\n      \"text\": \"Hi {{1}}, your order {{2}} is on its way.\",\n      \"example\": {\n        \"body_text\": [\n          [\n            \"John\",\n            \"#1234\"\n          ]\n        ]\n      }\n    },\n    {\n      \"type\": \"FOOTER\",\n      \"text\": \"Reply STOP to opt out\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete a template (every language, or one)",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/templates/:name?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "templates",
                ":name"
              ],
              "query": [
                {
                  "key": "language",
                  "value": "en",
                  "description": "Only this language. Default: every language.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "name",
                  "value": "order_update",
                  "description": "The template's name."
                }
              ]
            },
            "description": "Needs the 'templates:manage' scope. The template app2email uses for its own alerts cannot be deleted here. WABA-wide: every number on this WhatsApp Business Account uses the same templates.\n\nhttps://www.app2email.com/docs/api/templates/delete-template"
          },
          "response": []
        },
        {
          "name": "Delete several templates at once (all or nothing)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/templates/delete",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "templates",
                "delete"
              ]
            },
            "description": "Needs 'templates:manage'. names (every language) or ids, at most 100 languages; one bad id deletes nothing. WABA-wide: every number on this WhatsApp Business Account uses the same templates.\n\nhttps://www.app2email.com/docs/api/templates/delete-templates",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"names\": [\n    \"summer_sale\",\n    \"old_promo\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Archive a template (deleted by WhatsApp after 28 days)",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/templates/:name/archive?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "templates",
                ":name",
                "archive"
              ],
              "query": [
                {
                  "key": "language",
                  "value": "en",
                  "description": "Only this language. Default: every language.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "name",
                  "value": "order_update",
                  "description": "The template's name."
                }
              ]
            },
            "description": "Needs 'templates:manage'. Every language, or ?language=. Only APPROVED or REJECTED templates; unarchive within 28 days to keep it. WABA-wide: every number on this WhatsApp Business Account uses the same templates.\n\nhttps://www.app2email.com/docs/api/templates/archive-template"
          },
          "response": []
        },
        {
          "name": "Unarchive a template",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/templates/:name/unarchive?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "templates",
                ":name",
                "unarchive"
              ],
              "query": [
                {
                  "key": "language",
                  "value": "en",
                  "description": "Only this language. Default: every language.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "name",
                  "value": "order_update",
                  "description": "The template's name."
                }
              ]
            },
            "description": "Needs 'templates:manage'. Back to its previous status. Within 28 days of archiving. WABA-wide: every number on this WhatsApp Business Account uses the same templates.\n\nhttps://www.app2email.com/docs/api/templates/unarchive-template"
          },
          "response": []
        },
        {
          "name": "Compare two templates: block rate, sends, top block reason",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/templates/:name/compare?with=summer_sale_v2",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "templates",
                ":name",
                "compare"
              ],
              "query": [
                {
                  "key": "with",
                  "value": "summer_sale_v2",
                  "description": "The other template's name."
                },
                {
                  "key": "language",
                  "value": "en",
                  "description": "The template's language (eg en, en_US). Needed when the template has several.",
                  "disabled": true
                },
                {
                  "key": "with_language",
                  "value": "en",
                  "description": "The other template's language.",
                  "disabled": true
                },
                {
                  "key": "days",
                  "value": "30",
                  "description": "How far back: 7, 30, 60 or 90 days.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "name",
                  "value": "order_update",
                  "description": "The template's name."
                }
              ]
            },
            "description": "Both templates of this account, each sent at least 1,000 times in the period.\n\nhttps://www.app2email.com/docs/api/templates/compare-templates"
          },
          "response": []
        },
        {
          "name": "Create or update an authentication template in many languages",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/templates/:name/authentication",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "templates",
                ":name",
                "authentication"
              ],
              "variable": [
                {
                  "key": "name",
                  "value": "verify_code",
                  "description": "The authentication template's name."
                }
              ]
            },
            "description": "Needs 'templates:manage'. Missing languages are created, existing ones updated, in one call. Not for business-scoped user ids (131062). WABA-wide: every number on this WhatsApp Business Account uses the same templates.\n\nhttps://www.app2email.com/docs/api/templates/upsert-auth-template",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"languages\": [\n    \"en_US\",\n    \"es_ES\"\n  ],\n  \"otp_type\": \"COPY_CODE\",\n  \"add_security_recommendation\": true,\n  \"code_expiration_minutes\": 10\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Authentication template texts, per language",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/template-previews?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "template-previews"
              ],
              "query": [
                {
                  "key": "languages",
                  "value": "en_US,es_ES",
                  "description": "Comma separated (eg en_US,es_ES). Default: every language.",
                  "disabled": true
                },
                {
                  "key": "add_security_recommendation",
                  "value": "",
                  "description": "With the security line.",
                  "disabled": true
                },
                {
                  "key": "code_expiration_minutes",
                  "value": "",
                  "description": "With the expiry footer (1 to 90).",
                  "disabled": true
                }
              ]
            },
            "description": "The fixed texts WhatsApp puts into an authentication template (body, security line, expiry footer, buttons).\n\nhttps://www.app2email.com/docs/api/templates/preview-auth-templates"
          },
          "response": []
        },
        {
          "name": "Meta's Template Library (pre-approved templates)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/template-library?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "template-library"
              ],
              "query": [
                {
                  "key": "search",
                  "value": "delivery",
                  "description": "Words in the template.",
                  "disabled": true
                },
                {
                  "key": "topic",
                  "value": "",
                  "description": "eg ORDER_MANAGEMENT, PAYMENTS, ACCOUNT_UPDATE, CUSTOMER_FEEDBACK.",
                  "disabled": true
                },
                {
                  "key": "usecase",
                  "value": "",
                  "description": "eg SHIPMENT_CONFIRMATION, PAYMENT_DUE_REMINDER.",
                  "disabled": true
                },
                {
                  "key": "industry",
                  "value": "",
                  "description": "E_COMMERCE or FINANCIAL_SERVICES.",
                  "disabled": true
                },
                {
                  "key": "language",
                  "value": "",
                  "description": "eg en_US.",
                  "disabled": true
                },
                {
                  "key": "name",
                  "value": "",
                  "description": "A library template's name.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "",
                  "description": "1 to 200.",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "next_cursor of the previous answer.",
                  "disabled": true
                }
              ]
            },
            "description": "Utility and authentication templates written by Meta. Create one with POST /templates and library_template_name.\n\nhttps://www.app2email.com/docs/api/templates/list-template-library"
          },
          "response": []
        },
        {
          "name": "Template insights: sent, delivered, read, clicked, cost",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/template-insights?templates=summer_sale",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "template-insights"
              ],
              "query": [
                {
                  "key": "templates",
                  "value": "summer_sale",
                  "description": "Template names, comma separated."
                },
                {
                  "key": "language",
                  "value": "",
                  "description": "Only this language.",
                  "disabled": true
                },
                {
                  "key": "since",
                  "value": "",
                  "description": "First day, YYYY-MM-DD. Default: 6 days before until.",
                  "disabled": true
                },
                {
                  "key": "until",
                  "value": "",
                  "description": "Last day, YYYY-MM-DD. Default: today.",
                  "disabled": true
                },
                {
                  "key": "metrics",
                  "value": "",
                  "description": "Comma separated: sent, delivered, read, clicked, cost. Default: all.",
                  "disabled": true
                },
                {
                  "key": "product",
                  "value": "cloud_api",
                  "description": "cloud_api (default) or marketing_messages.",
                  "disabled": true
                }
              ]
            },
            "description": "Per template and day (UTC), 90 days back, at most 10 template languages. Insights must be on (POST); not for EU or Japan accounts.\n\nhttps://www.app2email.com/docs/api/templates/get-template-insights"
          },
          "response": []
        },
        {
          "name": "Switch template insights on (cannot be undone)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/template-insights",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "template-insights"
              ]
            },
            "description": "Needs 'templates:manage' and {\"confirm\": true}. Adds link tracking and lets Meta collect anonymised chat data. WABA-wide: every number on this WhatsApp Business Account uses the same templates.\n\nhttps://www.app2email.com/docs/api/templates/enable-template-insights",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"confirm\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Flows",
      "description": "WhatsApp Flows: forms and screens inside WhatsApp. Shared by every number of the WhatsApp Business Account.",
      "item": [
        {
          "name": "List WhatsApp Flows",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/flows?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "flows"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "1 to 100.",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "next_cursor of the previous answer.",
                  "disabled": true
                }
              ]
            },
            "description": "Every flow of the WhatsApp Business Account: id, name, status, categories, validation errors. This number's Book-and-Pay Flows also have `key`, `can_send` and `booking_flow` (POST /flows/{key}/send sends them); the first page adds the Book-and-Pay Flows not uploaded yet (no id). Needs 'messages:read' or 'bookings:manage'.\n\nhttps://www.app2email.com/docs/api/flows/list-flows"
          },
          "response": []
        },
        {
          "name": "Create a flow (draft, or published at once)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/flows",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "flows"
              ]
            },
            "description": "Needs 'templates:manage'. A draft; with flow_json and publish: true it is published at once (cannot be undone). WABA-wide: every number on this WhatsApp Business Account shares its flows.\n\nhttps://www.app2email.com/docs/api/flows/create-flow",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"appointment_booking\",\n  \"categories\": [\n    \"APPOINTMENT_BOOKING\"\n  ],\n  \"flow_json\": {\n    \"version\": \"7.2\",\n    \"screens\": [\n      {\n        \"id\": \"WELCOME\",\n        \"title\": \"Welcome\",\n        \"terminal\": true,\n        \"success\": true,\n        \"data\": {},\n        \"layout\": {\n          \"type\": \"SingleColumnLayout\",\n          \"children\": [\n            {\n              \"type\": \"TextHeading\",\n              \"text\": \"Book a visit\"\n            },\n            {\n              \"type\": \"Footer\",\n              \"label\": \"Done\",\n              \"on-click-action\": {\n                \"name\": \"complete\",\n                \"payload\": {}\n              }\n            }\n          ]\n        }\n      }\n    ]\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "One flow: status, validation errors, health",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/flows/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "flows",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "1234567890123456",
                  "description": "The flow's id (digits)."
                }
              ]
            },
            "description": "Status, categories, validation errors, Flow JSON version, endpoint, and whether it can be sent (health_status).\n\nhttps://www.app2email.com/docs/api/flows/get-flow"
          },
          "response": []
        },
        {
          "name": "Change a flow's name, categories or endpoint",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/flows/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "flows",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "1234567890123456",
                  "description": "The flow's id (digits)."
                }
              ]
            },
            "description": "Needs 'templates:manage'. The Flow JSON: PUT /flows/{id}/json. A published flow goes back to DRAFT until you publish it again; messages already sent keep the old version. WABA-wide: every number on this WhatsApp Business Account shares its flows.\n\nhttps://www.app2email.com/docs/api/flows/update-flow",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"appointment_booking_v2\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete a draft flow",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/flows/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "flows",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "1234567890123456",
                  "description": "The flow's id (digits)."
                }
              ]
            },
            "description": "Needs 'templates:manage'. Drafts only; deprecate a published flow instead. WABA-wide: every number on this WhatsApp Business Account shares its flows.\n\nhttps://www.app2email.com/docs/api/flows/delete-flow"
          },
          "response": []
        },
        {
          "name": "A flow's Flow JSON",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/flows/:id/json",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "flows",
                ":id",
                "json"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "1234567890123456",
                  "description": "The flow's id (digits)."
                }
              ]
            },
            "description": "The flow.json WhatsApp keeps for the flow.\n\nhttps://www.app2email.com/docs/api/flows/get-flow-json"
          },
          "response": []
        },
        {
          "name": "Replace a flow's Flow JSON",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/flows/:id/json",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "flows",
                ":id",
                "json"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "1234567890123456",
                  "description": "The flow's id (digits)."
                }
              ]
            },
            "description": "Needs 'templates:manage'. The body is the Flow JSON (or {\"flow_json\": {...}}), max 10 MB; the answer lists WhatsApp's validation errors. A published flow goes back to DRAFT until you publish it again; messages already sent keep the old version. WABA-wide: every number on this WhatsApp Business Account shares its flows.\n\nhttps://www.app2email.com/docs/api/flows/update-flow-json",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"version\": \"7.2\",\n  \"screens\": [\n    {\n      \"id\": \"WELCOME\",\n      \"title\": \"Welcome\",\n      \"terminal\": true,\n      \"success\": true,\n      \"data\": {},\n      \"layout\": {\n        \"type\": \"SingleColumnLayout\",\n        \"children\": [\n          {\n            \"type\": \"TextHeading\",\n            \"text\": \"Book a visit\"\n          },\n          {\n            \"type\": \"Footer\",\n            \"label\": \"Done\",\n            \"on-click-action\": {\n              \"name\": \"complete\",\n              \"payload\": {}\n            }\n          }\n        ]\n      }\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Publish a flow (cannot be undone)",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/flows/:id/publish",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "flows",
                ":id",
                "publish"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "1234567890123456",
                  "description": "The flow's id (digits)."
                }
              ]
            },
            "description": "Needs 'templates:manage'. A draft without validation errors. Afterwards it cannot be deleted (deprecate it instead); a change puts it back to DRAFT until published again. WABA-wide: every number on this WhatsApp Business Account shares its flows.\n\nhttps://www.app2email.com/docs/api/flows/publish-flow"
          },
          "response": []
        },
        {
          "name": "Deprecate a published flow (cannot be undone)",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/flows/:id/deprecate",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "flows",
                ":id",
                "deprecate"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "1234567890123456",
                  "description": "The flow's id (digits)."
                }
              ]
            },
            "description": "Needs 'templates:manage'. It can no longer be sent or opened. WABA-wide: every number on this WhatsApp Business Account shares its flows.\n\nhttps://www.app2email.com/docs/api/flows/deprecate-flow"
          },
          "response": []
        },
        {
          "name": "A public preview link of a flow (30 days)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/flows/:id/preview",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "flows",
                ":id",
                "preview"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "1234567890123456",
                  "description": "The flow's id (digits)."
                }
              ]
            },
            "description": "Anyone with the link can open it, also in an iframe. A new link: POST.\n\nhttps://www.app2email.com/docs/api/flows/get-flow-preview"
          },
          "response": []
        },
        {
          "name": "A new preview link of a flow (the old one stops working)",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/flows/:id/preview",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "flows",
                ":id",
                "preview"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "1234567890123456",
                  "description": "The flow's id (digits)."
                }
              ]
            },
            "description": "Needs 'templates:manage'. Meta's preview.invalidate(true): the old link stops working at once.\n\nhttps://www.app2email.com/docs/api/flows/renew-flow-preview"
          },
          "response": []
        },
        {
          "name": "The number's public key for flows with a data endpoint",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/flows/encryption-key",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "flows",
                "encryption-key"
              ]
            },
            "description": "This number only (each number has its own key). signature_status MISMATCH: set the key again. set_by: bookings when it is the key Book-and-Pay made for its Flows.\n\nhttps://www.app2email.com/docs/api/flows/get-flow-encryption-key"
          },
          "response": []
        },
        {
          "name": "Set the number's public key for flow endpoints",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/flows/encryption-key",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "flows",
                "encryption-key"
              ]
            },
            "description": "Needs 'templates:manage'. A 2048-bit RSA public key, PEM; a private key is refused unsent. This number only. 409 `encryption_key_managed` while Book-and-Pay has its key for the number (one key per number at WhatsApp).\n\nhttps://www.app2email.com/docs/api/flows/set-flow-encryption-key",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"public_key\": \"-----BEGIN PUBLIC KEY-----\\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAx...\\n-----END PUBLIC KEY-----\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Book-and-Pay",
      "description": "Appointment bookings made on WhatsApp Flows: the appointments, the free slots, the booking settings, and sending the number's Flows.",
      "item": [
        {
          "name": "The waitlist of full days",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/waitlist?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "waitlist"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "2026-11-13",
                  "description": "The first day, YYYY-MM-DD in the business time zone. Default today.",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "2026-12-31",
                  "description": "The last day (included). Default from + 60 days; at most 366 days.",
                  "disabled": true
                },
                {
                  "key": "service_id",
                  "value": "",
                  "description": "Only this service.",
                  "disabled": true
                },
                {
                  "key": "contact",
                  "value": "",
                  "description": "Only this customer (number with country code, digits only, or business-scoped user id).",
                  "disabled": true
                },
                {
                  "key": "include_closed",
                  "value": "",
                  "description": "true: also booked, expired and removed entries.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "",
                  "description": "At most this many entries (1 to 1000, default 500).",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). The customers waiting for a time, soonest day first, oldest entry first. Active entries (pending_confirm, waiting, notified) unless include_closed. When a time frees up (a cancellation, a move, a removed time block, and every 5 minutes) the waiting customers of that day get a WhatsApp message with a link to book it; the first booking wins. 409 `waitlist_not_set_up` while the waitlist is not available on the server.\n\nhttps://www.app2email.com/docs/api/book-and-pay/list-booking-waitlist"
          },
          "response": []
        },
        {
          "name": "Put a customer on the waitlist of a full day",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/waitlist",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "waitlist"
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. The service must have its waitlist on, the day must be bookable and have no free time left (or the group time in slot_id must be full) - force: true skips the free-time check. One active entry per customer, service and day: asking again answers 200 with that entry (existing: true). Sends `waitlist.joined`. The customer is offered a time when one opens.\n\nhttps://www.app2email.com/docs/api/book-and-pay/add-to-booking-waitlist",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contact\": \"61412345678\",\n  \"name\": \"Jane\",\n  \"service_id\": \"haircut\",\n  \"date\": \"2026-11-20\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Take a customer off the waitlist",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/waitlist/:reference/remove",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "waitlist",
                ":reference",
                "remove"
              ],
              "variable": [
                {
                  "key": "reference",
                  "value": "WL-4HT9XC",
                  "description": "The entry's reference (or its id)."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. The customer is not messaged. Sends `waitlist.removed`. An entry that is already closed answers 200 as it is.\n\nhttps://www.app2email.com/docs/api/book-and-pay/remove-from-booking-waitlist"
          },
          "response": []
        },
        {
          "name": "The appointments, soonest start first",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "2026-11-10",
                  "description": "Only appointments starting at or after this day (YYYY-MM-DD, business time zone) or ISO 8601 time.",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "2026-11-16",
                  "description": "Only appointments starting on or before this day (YYYY-MM-DD, included) or before this ISO 8601 time.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "confirmed",
                  "description": "Only this status.",
                  "disabled": true
                },
                {
                  "key": "contact",
                  "value": "61412345678",
                  "description": "Only this customer (number with country code, or business-scoped user id).",
                  "disabled": true
                },
                {
                  "key": "provider_id",
                  "value": "maria",
                  "description": "Only this staff member's appointments (GET /bookings/staff).",
                  "disabled": true
                },
                {
                  "key": "upcoming",
                  "value": "false",
                  "description": "true: confirmed appointments starting now or later, soonest first (status, from, to and order are then ignored).",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "smith",
                  "description": "Appointments whose customer name, reference or number contains this text.",
                  "disabled": true
                },
                {
                  "key": "order",
                  "value": "asc",
                  "description": "asc: soonest start first (default). desc: latest start first.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). Booked on WhatsApp, from the dashboard or through the API. Filter by a range of days (business time zone) or times, a status, or one contact; `order=desc` for the latest start first. Page with `next_cursor`.\n\nhttps://www.app2email.com/docs/api/book-and-pay/list-bookings"
          },
          "response": []
        },
        {
          "name": "Book an appointment for a customer at a free slot",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings"
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. The slot must be one of GET /bookings/availability (on the grid, inside the hours, free; the business's own minimum notice does not apply). The customer gets the confirmation on WhatsApp (a text with a calendar file inside their 24 hour window, else the booking confirmation template) unless `notify` is false; the business gets an email, the calendar event is written, and `booking.created` is sent (with `hold: true` when made from a hold). 409 `booking_slot_taken` when the time went meanwhile. To book a time kept with POST /bookings/holds, send its `hold` reference. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again.\n\nhttps://www.app2email.com/docs/api/book-and-pay/create-booking",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contact\": \"61412345678\",\n  \"service_id\": \"haircut\",\n  \"start\": \"2026-11-10T09:00\",\n  \"name\": \"John Smith\",\n  \"email\": \"john@example.com\",\n  \"notes\": \"First visit\",\n  \"provider_id\": \"maria\",\n  \"notify\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The free slots per day for a service, as the customer would see them",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/availability?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "availability"
              ],
              "query": [
                {
                  "key": "service_id",
                  "value": "haircut",
                  "description": "The service (config.services[].id).",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "2026-11-10",
                  "description": "The first day, YYYY-MM-DD in the business time zone. Default today.",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "2026-11-16",
                  "description": "The last day (included). Default from + 6 days; at most 32 days.",
                  "disabled": true
                },
                {
                  "key": "provider_id",
                  "value": "maria",
                  "description": "One staff member's own availability (config.providers[].id). Left out: anyone available.",
                  "disabled": true
                },
                {
                  "key": "addons",
                  "value": "deep,trim",
                  "description": "A comma list of the service's add-on ids: the slots are long enough for them.",
                  "disabled": true
                },
                {
                  "key": "seats",
                  "value": "1",
                  "description": "The places wanted on a group time (1 + guests): only times with that many places left.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). Every day of the range (at most 32 days, default today + 6) with its free start times: the opening hours, the closed days, the booked appointments and the calendar's busy time applied. Each slot's `id` is the local time `POST /bookings` takes as `start`. With staff members, `providers` names who is free; `provider_id` asks for one member's own availability.\n\nhttps://www.app2email.com/docs/api/book-and-pay/get-booking-availability"
          },
          "response": []
        },
        {
          "name": "The booking report of a range of days",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/reports?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "reports"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "2026-11-01",
                  "description": "The first day, YYYY-MM-DD in the business time zone.",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "2026-11-30",
                  "description": "The last day (included). With from alone: from + 29 days.",
                  "disabled": true
                },
                {
                  "key": "days",
                  "value": "30",
                  "description": "Instead of from / to: the last N days up to today (1 to 366; 7, 30 or 90 also give the older keys). Default 30.",
                  "disabled": true
                },
                {
                  "key": "service_id",
                  "value": "",
                  "description": "Only this service (service is taken too).",
                  "disabled": true
                },
                {
                  "key": "provider_id",
                  "value": "",
                  "description": "Only this staff member (provider is taken too).",
                  "disabled": true
                },
                {
                  "key": "format",
                  "value": "json",
                  "description": "csv: one line per appointment. csv_summary: the older metric,value lines.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). Over the appointments whose START is in the range (days in the business time zone): totals (bookings, upcoming, completed, cancelled and by the customer, no-shows, the no-show and cancel rates, new and returning customers, revenue and refunds in minor units, the average days booked ahead, the online share), per day, per weekday and hour, per service, staff member and source, and the waitlist numbers. Revenue = online payments of those appointments, less refunds. The range: from / to (at most 366 days), or days (the last N days up to today; default 30). With days=7, 30 or 90 (or nothing) the answer also has the keys of the older report (bookings, completed, cancelled, no_shows, csat, reminders_sent, sessions, top_services, per_provider, nudges). `format=csv`: one line per appointment (reference, date, time, service, staff, customer name, customer phone, status, source, price, paid, add-ons, guests, series, answers); `format=csv_summary`: the older metric,value lines.\n\nhttps://www.app2email.com/docs/api/book-and-pay/get-booking-reports"
          },
          "response": []
        },
        {
          "name": "One appointment, by id or reference",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "BK-7Q3M2A",
                  "description": "The booking's id, or its reference (BK-XXXXXX)."
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`).\n\nhttps://www.app2email.com/docs/api/book-and-pay/get-booking"
          },
          "response": []
        },
        {
          "name": "Cancel an appointment",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/:id/cancel",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                ":id",
                "cancel"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "BK-7Q3M2A",
                  "description": "The booking's id, or its reference (BK-XXXXXX)."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. The calendar event is removed, `booking.cancelled` is sent, and the customer is told on WhatsApp (a text inside their 24 hour window, else the cancellation template) unless `notify` is false. 409 `booking_cancelled` when it already was.\n\nhttps://www.app2email.com/docs/api/book-and-pay/cancel-booking",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reason\": \"customer asked by phone\",\n  \"notify\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Mark an appointment completed, a no-show, or back to confirmed",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/:id/status",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                ":id",
                "status"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "BK-7Q3M2A",
                  "description": "The booking's id, or its reference (BK-XXXXXX)."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. Completed appointments get the follow-up message (aftercare and the rating buttons) when the business turned it on; the reports count both. An appointment that is not marked is completed by itself 24 hours after its end. A cancelled appointment cannot be marked (409 `booking_cancelled`).\n\nhttps://www.app2email.com/docs/api/book-and-pay/set-booking-status",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"status\": \"completed\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The booking settings, the default Flow's status and every Flow",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/booking",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "booking"
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). Every key of the configuration with its value (defaults filled in): the trigger words, the hours, the services, the messages, the calendar, the staff members; plus the number's Book-and-Pay Flows (as booking_flow in GET /flows).\n\nhttps://www.app2email.com/docs/api/book-and-pay/get-booking-settings"
          },
          "response": []
        },
        {
          "name": "Switch Book-and-Pay on or off and change the settings",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/booking",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "booking"
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. `config` is partial: a section object is merged key by key into the stored section, a list (services, providers, schedule.overrides) or a single value replaces what is stored. The whole result is checked against the rules of every section (400 `invalid_setting` with `details.problems`; nothing is saved then). Switching Book-and-Pay on also creates the utility templates bookings send outside the 24 hour window (Meta reviews them).\n\nhttps://www.app2email.com/docs/api/book-and-pay/update-booking-settings",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enabled\": true,\n  \"config\": {\n    \"services\": [\n      {\n        \"id\": \"haircut\",\n        \"name\": \"Haircut\",\n        \"duration_min\": 30,\n        \"price\": \"$40\",\n        \"enabled\": true\n      },\n      {\n        \"id\": \"colour\",\n        \"name\": \"Colour\",\n        \"duration_min\": 90,\n        \"price\": \"$120\",\n        \"enabled\": true\n      }\n    ],\n    \"schedule\": {\n      \"timezone\": \"Australia/Sydney\",\n      \"min_notice_min\": 60\n    }\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Send a Flow to a contact (the booking form or another form)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/flows/:key/send",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "flows",
                ":key",
                "send"
              ],
              "variable": [
                {
                  "key": "key",
                  "value": "booking",
                  "description": "The Flow's key (GET /flows)."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. A Flow of the number's Book-and-Pay section, by its `key` (GET /flows). A Flow message is free-form: it can only go to a contact who wrote to the number in the last 24 hours (422 `outside_24h_window`; send an approved template first, then the Flow when they answer). The Flow must be enabled and published (409 `flow_not_published`). The contact's answers come back as `booking.created` (a booking Flow) or `flow.completed` (a form Flow). Counts as one message of the plan.\n\nhttps://www.app2email.com/docs/api/book-and-pay/send-flow",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contact\": \"61412345678\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Tickets-and-Pay",
      "description": "Event tickets: events with one or many dates, ticket types and extras, what is left, orders and refunds, the tickets with their check-in state, promo codes, the waiting list and door lists. Create a key with the permission Event tickets on the API keys page. Your systems can list events and what is left, find an order, issue complimentary tickets or record a sale paid at your till, refund, send tickets again, and check tickets in from your own scanner. Eight webhook events report an order confirmed or refunded, a ticket checked in or passed on, a date sold out or cancelled, a waiting-list entry and an erased buyer. AI assistants can do the same through the hosted MCP server. Sandbox keys can read but cannot issue, refund or check in.",
      "item": [
        {
          "name": "The events, newest first",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/events?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "events"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "draft",
                  "description": "Only events in this state. Left out: all four.",
                  "disabled": true
                },
                {
                  "key": "archived",
                  "value": "",
                  "description": "true: the archived events only. Left out: the ones that are not archived.",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "quiz",
                  "description": "Search in the name, the slug or the EV- code (2 to 80 characters).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `tickets:manage`. The events of the number, newest first, each with its next date, how many tickets are sold and the lowest price. `status` filters by state, `archived=true` lists the archived ones instead, `q` searches the name, the slug and the code (EV-XXXXX). The rows have no `dates`, `types` or `problems`: GET /tickets/events/{id} has them. Page with `next_cursor`.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/list-ticket-events"
          },
          "response": []
        },
        {
          "name": "Create an event as a draft with one date and one ticket type",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/events",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "events"
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. Makes a draft with one date and the ticket type General admission at `price` (0 or left out: free). `start` is local time in the number's time zone (2026-12-12T19:30) or ISO 8601 with an offset, and must be in the future. Time zone and currency start as the number's. Nothing is on sale until POST /tickets/events/{id}/publish. 409 `ticket_limit_reached` at 200 events. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/create-ticket-event",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Summer Quiz\",\n  \"start\": \"2026-12-12T19:30\",\n  \"price\": 12\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "One event with its dates and ticket types",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/events/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "events",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "summer-quiz",
                  "description": "The event: its id, its slug (eg summer-quiz) or its code (EV-XXXXX)."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. By id, slug or code (EV-XXXXX). With its scheduled dates (soonest first, at most 50; `dates_more` says there are more, and GET /tickets/events/{id}/dates pages through all of them), its ticket types that are not archived and, for a draft, `problems`: what still stops publishing (empty: it can be published).\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/get-ticket-event"
          },
          "response": []
        },
        {
          "name": "Change an event",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/events/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "events",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "summer-quiz",
                  "description": "The event: its id, its slug (eg summer-quiz) or its code (EV-XXXXX)."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. Send only the keys to change: `name`, `summary`, `description`, `visibility`, `sales` (on or paused), `capacity`, `held_back`, `timezone`, `currency` (refused once an order exists), `sales_start`, `slug` (until the first publish) and `settings` (merged key by key at the top level, then checked as a whole). `notify` true tells ticket holders when the venue changed. The status, the schedule, the seat plan and the pictures are changed on the dashboard: 400 `invalid_ticket_event` names a key that cannot be changed here. A capacity below what is sold is saved and `note` says so. 400 `nothing_to_change` without any of the keys. `ticket.event.sold_out` is sent when a lower limit makes a date full.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/update-ticket-event",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"summary\": \"A night of questions on the terrace.\",\n  \"sales\": \"paused\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Publish an event so tickets can be bought",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/events/:id/publish",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "events",
                ":id",
                "publish"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "summer-quiz",
                  "description": "The event: its id, its slug (eg summer-quiz) or its code (EV-XXXXX)."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. No body. Puts the event on sale on its page (`url`) and in the WhatsApp chat. Needs ticket sales switched on for the number (403 `tickets_not_enabled`) and in its plan (403 `plan_not_allowed`). 409 `ticket_event_not_publishable` lists what is missing in `details.problems`. An event that is already published answers 200 and `note` says so.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/publish-ticket-event"
          },
          "response": []
        },
        {
          "name": "Cancel an event and refund or void its tickets",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/events/:id/cancel",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "events",
                ":id",
                "cancel"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "summer-quiz",
                  "description": "The event: its id, its slug (eg summer-quiz) or its code (EV-XXXXX)."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. Cancels every scheduled date of the event. `refund` says what happens to the tickets: all = everything paid goes back, prices = the ticket prices without booking fees and donations, none = the tickets are voided and no money moves. `confirm` must be the word CANCEL. The answer comes at once (`started` true); the orders are refunded one by one in the background through the business's own payment provider, the ticket holders are told unless `notify` is false, `ticket.order.refunded` is sent for each order and `ticket.event.cancelled` for each date when it has finished. It cannot be undone. 409 `ticket_not_allowed` when the event is already cancelled or has ended. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/cancel-ticket-event",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"refund\": \"all\",\n  \"reason\": \"The venue is closed\",\n  \"confirm\": \"CANCEL\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The dates of an event with what is sold and left",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/events/:id/dates?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "events",
                ":id",
                "dates"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "scheduled",
                  "description": "Default scheduled.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "2026-12-01",
                  "description": "Dates that start on or after this day (YYYY-MM-DD in the event's time zone) or ISO 8601 time.",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "2026-12-31",
                  "description": "Dates that start up to this day (included) or ISO 8601 time.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "summer-quiz",
                  "description": "The event: its id, its slug (eg summer-quiz) or its code (EV-XXXXX)."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. The dates of an event, soonest first, each with what is sold, held in baskets, left and checked in. `status` is scheduled (the default), ended, cancelled or all; `from` and `to` are days (YYYY-MM-DD in the event's time zone) or ISO 8601 times. Page with `next_cursor`.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/list-ticket-dates"
          },
          "response": []
        },
        {
          "name": "Add a date to an event",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/events/:id/dates",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "events",
                ":id",
                "dates"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "summer-quiz",
                  "description": "The event: its id, its slug (eg summer-quiz) or its code (EV-XXXXX)."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. `start` is local time in the event's time zone or ISO 8601 with an offset, in the future. `end` defaults to 120 minutes after `start` (it must be after it, at most 31 days later). `capacity`: -1 = the event's (the default), 0 = no limit, else people. 409 `ticket_limit_reached` at 400 scheduled dates; 409 `ticket_not_allowed` when the event is cancelled; 400 `invalid_ticket_event` when the event already has a date at that time. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/create-ticket-date",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"start\": \"2026-12-19T19:30\",\n  \"label\": \"Late show\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Change a date: time, label, capacity, sales on or paused",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/dates/:date_id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "dates",
                ":date_id"
              ],
              "variable": [
                {
                  "key": "date_id",
                  "value": "31",
                  "description": "The date's id."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. Send only the keys to change: `start`, `end`, `label`, `capacity`, `sales` (on or paused). `notify` true tells the ticket holders about a new time, on WhatsApp or by email. A date with valid tickets cannot be moved into the past. 400 `nothing_to_change` without any of the keys. `ticket.event.sold_out` is sent when a lower limit makes a date full.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/update-ticket-date",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"start\": \"2026-12-12T20:00\",\n  \"end\": \"2026-12-12T22:00\",\n  \"notify\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Cancel one date and refund or void its tickets",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/dates/:date_id/cancel",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "dates",
                ":date_id",
                "cancel"
              ],
              "variable": [
                {
                  "key": "date_id",
                  "value": "31",
                  "description": "The date's id."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. Cancels this one date; the other dates of the event go on. `refund`: all = everything paid goes back, prices = the ticket prices without booking fees and donations, none = the tickets are voided and no money moves. `confirm` must be the word CANCEL. The answer comes at once (`started` true); the orders are refunded one by one in the background, the ticket holders are told unless `notify` is false, `ticket.order.refunded` is sent for each order and `ticket.event.cancelled` when it has finished. It cannot be undone. 409 `ticket_not_allowed` when the date is already cancelled or has ended. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/cancel-ticket-date",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"refund\": \"all\",\n  \"reason\": \"The venue is closed that day\",\n  \"confirm\": \"CANCEL\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The door list of a date for your own scanner",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/dates/:date_id/door?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "dates",
                ":date_id",
                "door"
              ],
              "query": [
                {
                  "key": "since",
                  "value": "u1793926800000000.502",
                  "description": "The cursor of an earlier answer. Left out: from the start.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "2000",
                  "description": "How many (1 to 2000, default 2000).",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "date_id",
                  "value": "31",
                  "description": "The date's id."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. For a scanner of your own. Each ticket of the date comes with `code_sha256`, the lower-case hex SHA-256 of the text in its QR code: hash what you scan and look it up, so the codes themselves never leave app2email. No contact, email or money is in the list. The first calls page through the date (while `more` is true, send `cursor` as `since`); later the same call with the last `cursor` answers only what changed, and `gone` lists the ids that are no longer tickets of this date. Record an admission with POST /tickets/check-ins.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/get-ticket-door-list"
          },
          "response": []
        },
        {
          "name": "The ticket types and extras of an event",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/events/:id/types?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "events",
                ":id",
                "types"
              ],
              "query": [
                {
                  "key": "archived",
                  "value": "",
                  "description": "true: include the archived ticket types.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "summer-quiz",
                  "description": "The event: its id, its slug (eg summer-quiz) or its code (EV-XXXXX)."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. The ticket types and the extras (role addon) of an event, in their order, with the price as typed and the all-in price a buyer pays. `archived=true` includes the archived ones.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/list-ticket-types"
          },
          "response": []
        },
        {
          "name": "Add a ticket type or an extra to an event",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/events/:id/types",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "events",
                ":id",
                "types"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "summer-quiz",
                  "description": "The event: its id, its slug (eg summer-quiz) or its code (EV-XXXXX)."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. `name` is needed; everything else has a default (a free ticket that admits one person and has no limit of its own). `role` addon makes an extra such as parking, bought together with a ticket. `price_mode` choose lets the buyer name the amount, from `min_price`. `pool_id`, `opens_after` and `needs` point at a pool or another ticket type of the same event (0 = none). 409 `ticket_limit_reached` at 40 ticket types. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/create-ticket-type",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Child\",\n  \"price\": 6\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Change or archive a ticket type",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/types/:type_id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "types",
                ":type_id"
              ],
              "variable": [
                {
                  "key": "type_id",
                  "value": "44",
                  "description": "The ticket type's id."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. Send only the keys to change. `status` archived takes the ticket type off sale everywhere, at any time (the tickets sold stay valid); back to active is refused with 409 `ticket_limit_reached` while the event has 40 active ticket types. A ticket type on a seat plan is linked to its seat category on the dashboard, not here. 400 `nothing_to_change` without any key. `ticket.event.sold_out` is sent when a lower limit makes a date full.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/update-ticket-type",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"price\": 14,\n  \"quantity\": 80\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "What is on sale and how many are left for a date",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/events/:id/availability?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "events",
                ":id",
                "availability"
              ],
              "query": [
                {
                  "key": "date_id",
                  "value": "31",
                  "description": "The date's id. Needed when the event has more than one scheduled date.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "summer-quiz",
                  "description": "The event: its id, its slug (eg summer-quiz) or its code (EV-XXXXX)."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. For one date of an event: `on_sale` (buyers can buy now), `closed` (cancelled or ended when the date takes no order from anyone), `sold_out`, and every active ticket type with its `state` as a buyer meets it, how many are `left` (null: nothing limits it), the most one order may take (`max`) and the all-in price. `date_id` is needed when the event has several scheduled dates (400 `invalid_ticket_event` without it). Buyers buy on the event's `url`.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/get-ticket-availability"
          },
          "response": []
        },
        {
          "name": "The ticket orders, newest first",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/orders?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "orders"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "12",
                  "description": "Only orders of this event (its id).",
                  "disabled": true
                },
                {
                  "key": "date_id",
                  "value": "31",
                  "description": "Only orders for this date (its id).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "pending",
                  "description": "Only orders in this state. Left out: every state except pending and expired.",
                  "disabled": true
                },
                {
                  "key": "kind",
                  "value": "online",
                  "description": "online: paid by card. free: a free order. comp: complimentary. outside: paid outside.",
                  "disabled": true
                },
                {
                  "key": "contact",
                  "value": "61412345678",
                  "description": "The buyer: a WhatsApp number with country code, digits only, or a business-scoped user id.",
                  "disabled": true
                },
                {
                  "key": "email",
                  "value": "",
                  "description": "The buyer's email address.",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search in the reference, the buyer's or a holder's name, a seat label or a promo code (2 to 80 characters).",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "2026-11-01",
                  "description": "Orders made from this day (YYYY-MM-DD in the number's time zone) or ISO 8601 time.",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "2026-11-30",
                  "description": "Orders made up to this day (included) or ISO 8601 time.",
                  "disabled": true
                },
                {
                  "key": "attention",
                  "value": "",
                  "description": "true: only orders that need a look.",
                  "disabled": true
                },
                {
                  "key": "tickets",
                  "value": "",
                  "description": "true: each order carries its tickets.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Newest first. Left out, `status` gives every order except the unfinished checkouts (pending and expired). Find a buyer's orders with `contact`, `email` or `q` (the reference, the buyer's or a holder's name, a seat label, a promo code). `from` and `to` filter by the day the order was made; `attention=true` gives the orders that need a look (a failed or disputed payment, a refund that does not add up); `tickets=true` adds each order's tickets. `page_url` opens the tickets without a login: give it only to the buyer. Page with `next_cursor`.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/list-ticket-orders"
          },
          "response": []
        },
        {
          "name": "Issue complimentary tickets or record a sale paid outside",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/orders",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "orders"
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. Issues the tickets at once and never takes money: `kind` comp makes complimentary tickets (every price 0), `kind` outside records a sale that was paid outside app2email (cash, a bank transfer, a card machine) at the ticket prices. `items` names the ticket types and quantities; on an event with a seat plan the best free seats are taken unless `seat_keys` names them. Unless `notify` is false the buyer gets the tickets on WhatsApp (when `buyer.contact` is given) and by email (when `buyer.email` is given); with neither, share `order.page_url` yourself. `check_in_now` checks every ticket in at once (a sale at the door). `ticket.order.confirmed` is sent. Sales windows and hidden ticket types do not bind an order made here; the places kept for the door stay kept. 409 `tickets_sold_out` when there is no room, 409 `tickets_not_on_sale` for a date that is cancelled or over, 403 `tickets_not_enabled` while ticket sales are switched off. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/create-ticket-order",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"event_id\": \"summer-quiz\",\n  \"kind\": \"comp\",\n  \"items\": [\n    {\n      \"type_id\": 44,\n      \"quantity\": 2\n    }\n  ],\n  \"buyer\": {\n    \"name\": \"John Smith\",\n    \"contact\": \"61412345678\"\n  },\n  \"comp_reason\": \"guest\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "One order with its tickets, by id or reference",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/orders/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "orders",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "TK-7H3KQ9",
                  "description": "The order: its id or its reference (TK-XXXXXX)."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. By id or reference (TK-XXXXXX). The order with its money, the buyer and every ticket with its status and check-in state. `page_url` (on the order and on each valid ticket) opens the tickets without a login: treat it like a password and give it only to the buyer.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/get-ticket-order"
          },
          "response": []
        },
        {
          "name": "Refund an order or some of its tickets",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/orders/:id/refund",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "orders",
                ":id",
                "refund"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "TK-7H3KQ9",
                  "description": "The order: its id or its reference (TK-XXXXXX)."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. Refunds every valid ticket of the order, or only `ticket_ids`. `what`: all (the default) or prices (without booking fees and donations). `money` says how the money goes back: provider = through the business's own Stripe or PayPal account (real money, it cannot be undone), recorded = it was handed back outside, outside = the business refunded it at Stripe or PayPal itself, none = cancel without a refund. Left out, it follows the order: provider for an online order, recorded for a sale paid outside, none for free and complimentary tickets. The refunded tickets stop working at once and their places go back on sale; the buyer is told unless `notify` is false. `ticket.order.refunded` is sent. 409 `refund_not_possible` when nothing is left to refund, 409 `payments_not_connected`, 502 `payment_provider_error`. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/refund-ticket-order",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ticket_ids\": [\n    502\n  ],\n  \"reason\": \"cannot come\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Send the buyer their tickets again",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/orders/:id/resend",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "orders",
                ":id",
                "resend"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "TK-7H3KQ9",
                  "description": "The order: its id or its reference (TK-XXXXXX)."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. No body. The buyer gets the tickets again: a WhatsApp message (inside their 24 hour window, else a template) when the order has a number, and an email when it has an address. `sent` lists what happened per channel. 409 `ticket_not_allowed` when the order has no valid ticket, or neither a WhatsApp number nor an email address. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/resend-ticket-order"
          },
          "response": []
        },
        {
          "name": "The tickets (attendees) with their check-in state",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/issued?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "issued"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "12",
                  "description": "The tickets of this event (its id).",
                  "disabled": true
                },
                {
                  "key": "date_id",
                  "value": "31",
                  "description": "The tickets of this date (its id).",
                  "disabled": true
                },
                {
                  "key": "type_id",
                  "value": "",
                  "description": "Only this ticket type (its id).",
                  "disabled": true
                },
                {
                  "key": "order",
                  "value": "TK-7H3KQ9",
                  "description": "The tickets of this order: its id or its reference (TK-XXXXXX).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "valid",
                  "description": "Only tickets in this state. Left out: valid and blocked.",
                  "disabled": true
                },
                {
                  "key": "checked_in",
                  "value": "",
                  "description": "true: only tickets that were used at the door. false: only the ones that were not.",
                  "disabled": true
                },
                {
                  "key": "role",
                  "value": "ticket",
                  "description": "Default ticket.",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Search in the holder's or the buyer's name, the reference or a seat label (2 to 80 characters).",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `tickets:manage`. One row per ticket, by id, with the holder, the seat, the price, the check-in state and the buyer. `event_id`, `date_id` or `order` is needed (400 `invalid_ticket_order` without one). Left out, `status` gives the valid and the blocked tickets and `role` the admission tickets (addon: the extras, all: both). `checked_in=true` gives who is in, `checked_in=false` who has not come yet. Page with `next_cursor`.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/list-tickets"
          },
          "response": []
        },
        {
          "name": "One ticket",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/issued/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "issued",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "501",
                  "description": "The ticket's id (digits). The text of a ticket's QR code is never accepted in an address."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. By its id (digits). The text of a ticket's QR code is never accepted in an address: POST /tickets/check-ins takes it. The answer also has the order's id, reference, status and buyer.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/get-ticket"
          },
          "response": []
        },
        {
          "name": "Void one ticket without a refund",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/issued/:id/void",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "issued",
                ":id",
                "void"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "501",
                  "description": "The ticket's id (digits). The text of a ticket's QR code is never accepted in an address."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. The ticket stops working at the door and its place is back on sale. No money moves: to give money back use POST /tickets/orders/{id}/refund with `ticket_ids`. The buyer is told only with `notify` true. `ticket.order.refunded` is sent, with `money` none. 409 `ticket_not_allowed` when the ticket is already refunded, cancelled or passed on. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/void-ticket",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reason\": \"duplicate\",\n  \"notify\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Check a ticket in (or out) by its code or id",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/check-ins",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "check-ins"
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. Send `code` (the text of the ticket's QR code; a link or other text around it is fine) with `date_id`, or `ticket_id`. The answer is always 200 when the request was understood: `result` ok and `admitted` true mean let the person in; any other `result` (already_in, not_inside, unknown, refunded, cancelled, transferred, blocked, wrong_event, wrong_date, wrong_gate, too_early, too_late) is a refusal with the reason in `note`, not an error. `direction` out checks out, for events that count people leaving; `people` admits a part of a group ticket; `force` admits although it is too early, too late or the wrong entrance. `check_in.id` is the handle for the undo. `ticket.checked_in` is sent the first time a ticket is admitted. The code of a whole order is not taken: 400 `invalid_ticket_check_in`. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/check-in-ticket",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"code\": \"<the text of the QR code>\",\n  \"date_id\": 31\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Take a check-in back",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/check-ins/:scan_id/undo",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "check-ins",
                ":scan_id",
                "undo"
              ],
              "variable": [
                {
                  "key": "scan_id",
                  "value": "90211",
                  "description": "The check-in's id: check_in.id of the answer of POST /tickets/check-ins."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. No body. Takes one accepted check-in back (`scan_id` is `check_in.id` of the check-in answer), so the ticket can be used again. Once per check-in, while its date has not ended. 404 `ticket_check_in_not_found`; 409 `ticket_not_allowed` when it was already taken back or the date has ended.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/undo-ticket-check-in"
          },
          "response": []
        },
        {
          "name": "The promo and access codes with their uses",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/codes?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "codes"
              ],
              "query": [
                {
                  "key": "q",
                  "value": "EARLY",
                  "description": "Search in the code (2 to 80 characters).",
                  "disabled": true
                },
                {
                  "key": "enabled",
                  "value": "",
                  "description": "true: only codes that are switched on. false: only the ones switched off.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `tickets:manage`. The promo codes (a discount) and the access codes (they unlock hidden ticket types), by id, each with how many orders and tickets used it. `q` searches in the code, `enabled` filters. Page with `next_cursor`.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/list-ticket-codes"
          },
          "response": []
        },
        {
          "name": "Create a promo or access code",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/codes",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "codes"
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. `code` is 3 to 20 characters of A-Z, 0-9, _ and - (stored in upper case). `kind` percent takes a whole `value` from 1 to 100, `kind` amount an amount in `currency` (the default is the number's). `event_ids` and `type_ids` limit where it counts ([] = everywhere), `unlocks` lists hidden ticket types the code opens (then `value` may be 0), `starts` and `ends` are days, `limit` caps the uses per `limit_unit`. 409 `ticket_not_allowed` when a code with this name exists; 409 `ticket_limit_reached` at 1,000 codes. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/create-ticket-code",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"code\": \"EARLY10\",\n  \"kind\": \"percent\",\n  \"value\": 10,\n  \"event_ids\": [\n    12\n  ],\n  \"ends\": \"2026-12-01\",\n  \"limit\": 100\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Change a promo code or switch it off",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/codes/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "codes",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "EARLY10",
                  "description": "The promo code: its id, or the code itself."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. By id or by the code itself. Send only the keys to change; the code's own text cannot be changed (make a new code instead). `enabled` false switches it off. 400 `nothing_to_change` without any key.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/update-ticket-code",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enabled\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete a promo code no order has used",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/codes/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "codes",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "EARLY10",
                  "description": "The promo code: its id, or the code itself."
                }
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. By id or by the code itself. Only a code no order has used can be deleted: 409 `ticket_not_allowed` otherwise (switch it off with PATCH /tickets/codes/{id} instead).\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/delete-ticket-code"
          },
          "response": []
        },
        {
          "name": "The waiting list of a sold-out date",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/waitlist?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "waitlist"
              ],
              "query": [
                {
                  "key": "date_id",
                  "value": "31",
                  "description": "The date's id. Needed.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "waiting",
                  "description": "Only entries in this state. Left out: waiting and notified.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `tickets:manage`. The people waiting for a place on one date, in the order they joined. `date_id` is needed (400 `invalid_ticket_event` without it). Left out, `status` gives the waiting and the notified entries. Page with `next_cursor`. `ticket.waitlist.joined` reports each new entry.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/list-ticket-waitlist"
          },
          "response": []
        },
        {
          "name": "Sales and check-in figures of an event or one date",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/tickets/stats?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "tickets",
                "stats"
              ],
              "query": [
                {
                  "key": "event_id",
                  "value": "summer-quiz",
                  "description": "The event: its id, its slug or its code (EV-XXXXX). Needed.",
                  "disabled": true
                },
                {
                  "key": "date_id",
                  "value": "31",
                  "description": "Only this date (its id). Left out: all dates of the event.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `tickets:manage`. The figures of one event, or of one of its dates with `date_id`: confirmed orders, people sold, held in baskets, left and checked in, the money (gross, discounts, fees, tax, donations, refunded, net) and the split by ticket type, by channel and by promo code. Money is in the event's currency. `event_id` is needed (400 `invalid_ticket_event` without it).\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/get-ticket-stats"
          },
          "response": []
        },
        {
          "name": "The ticket settings and whether ticket sales are switched on",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/tickets",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "tickets"
              ]
            },
            "description": "Scope: `tickets:manage`. Works for every number, also before ticket sales are set up. `available` says whether ticket sales are open for this number at all (false: every other ticket call answers 403 `tickets_not_enabled`), `configured` whether the number has ticket settings, `enabled` and `selling` whether tickets are sold now, and `why` not (tables_missing, no_config, removed, off, plan). Also the address of the events page, the currency and the time zone new events start with, which of the business's payment providers can take a ticket payment, and `config`: the settings with every default filled in. Nothing is changed by this call.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/get-ticket-settings"
          },
          "response": []
        },
        {
          "name": "Switch ticket sales on or off and change the settings",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/tickets",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "tickets"
              ]
            },
            "description": "Scope: `tickets:manage`. Not with a sandbox key. `enabled` switches ticket sales on or off; `config` holds whole sections of the settings (organiser, hold_minutes, notify, brand, ticket_style, wa, privacy, texts): a section sent replaces the stored section, the others stay. The first call makes the ticket settings of the number. Switching off never strands what was sold: the tickets, refunds and the door go on working. 403 `tickets_not_enabled` while ticket sales are not open for this number, 403 `plan_not_allowed`, 400 `invalid_setting` with `details.problems`, 400 `nothing_to_change` with neither key. The answer is the one of GET /settings/tickets plus `note`.\n\nhttps://www.app2email.com/docs/api/tickets-and-pay/update-ticket-settings",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enabled\": true,\n  \"config\": {\n    \"hold_minutes\": 15\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Submit-Info",
      "description": "Forms a business defines as a plain list of questions. app2email turns each one into a WhatsApp form and a web page; what people send becomes a submission that moves through stages in a shared inbox and sets off automations: replies, e-mails, calculations and calls to outside systems. Start with GET /submit/guide, build everything with one POST /submit/setup, then publish the form.",
      "item": [
        {
          "name": "The Submit-Info guide for agents: every key, rule and example",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/guide",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "guide"
              ]
            },
            "description": "Scope: `submissions:manage`. Start here. One JSON document with everything needed to set Submit-Info up without reading anything else: every key of a form definition with its default and limit, the field types and how WhatsApp shows each, stage rules, rule operators, the automation triggers and actions with their keys and an example each, placeholders, formula functions, connection kinds, roles and abilities, limits, the presets, and three complete worked setups. `this_number` names the forms, lists and connections the number already has, so nothing is replaced by accident. Next: write a setup document and send it to POST /submit/setup with `dry_run` true.\n\nhttps://www.app2email.com/docs/api/submit-info/get-submit-guide"
          },
          "response": []
        },
        {
          "name": "Submit-Info settings: the switch, the config and the public code",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/settings",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "settings"
              ]
            },
            "description": "Scope: `submissions:manage`. `enabled` says whether Submit-Info is switched on for the number (words, links and automations work only then; everything can be set up while it is off). `config` holds every setting with its value: the default reference prefix, the menu and status words, where e-mails go, the time zone, the look of the web pages, shared inbox views and the retention time. `code` is the number's public code in every form and inbox address.\n\nhttps://www.app2email.com/docs/api/submit-info/get-submit-settings"
          },
          "response": []
        },
        {
          "name": "Switch Submit-Info on or off and change its settings",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/settings",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "settings"
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Send `enabled`, `config`, or both (400 `nothing_to_change` with neither). `config` is partial: only the keys you send change. A section such as `brand` is merged key by key; a list such as `menu_words` or `views` replaces what is stored. The result is checked as a whole (400 `invalid_settings` with the problems in `error.details`; nothing is saved then). Switching on makes the forms' words and links answer; a form still needs POST /submit/forms/{key}/publish to open inside WhatsApp.\n\nhttps://www.app2email.com/docs/api/submit-info/update-submit-settings",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enabled\": true,\n  \"config\": {\n    \"default_prefix\": \"AC\",\n    \"notify_email\": \"forms@example.com\",\n    \"brand\": {\n      \"color\": \"#1F6FEB\"\n    }\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Apply or dry-run a whole setup: forms, lists, automations",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/setup",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "setup"
              ]
            },
            "description": "Scope: `submissions:manage`. A sandbox key may only make a dry run. The one call that builds a solution: settings, lists, connections, forms and automations in one document (the SubmitSetup schema; GET /submit/guide has complete examples). Always send it with `dry_run` true first: the answer lists every problem with its path and a fix, and writes nothing. When `problems` is empty, send it again without `dry_run`. What exists under the same key is replaced (lists, connections, forms by `key`; automations by `name` within a form); everything else is left alone. With any problem nothing is written at all: 400 `invalid_setup` with the problems in `error.details`. `publish` names the forms to publish to WhatsApp after a clean apply; otherwise call POST /submit/forms/{key}/publish. A form that cannot be published does not undo the rest: the answer is still 200, `applied.published` names the forms that went live and `problems` says why another did not. `preset` in place of the parts installs a ready-made solution. If a save fails half-way (rare) the answer is 500 with `error.details.applied`: send the same document again, every part replaces what is there.\n\nhttps://www.app2email.com/docs/api/submit-info/apply-submit-setup",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"dry_run\": true,\n  \"settings\": {\n    \"enabled\": true\n  },\n  \"lists\": [\n    {\n      \"key\": \"products\",\n      \"name\": \"Products\",\n      \"items\": [\n        {\n          \"id\": \"pump-s\",\n          \"title\": \"Pump, small\",\n          \"description\": \"Up to 40 l/min\",\n          \"price\": 240\n        },\n        {\n          \"id\": \"pump-l\",\n          \"title\": \"Pump, large\",\n          \"description\": \"Up to 120 l/min\",\n          \"price\": 610\n        }\n      ]\n    }\n  ],\n  \"connections\": [\n    {\n      \"name\": \"ERP\",\n      \"kind\": \"http\",\n      \"base_url\": \"https://erp.example.com/api\",\n      \"auth\": {\n        \"type\": \"bearer\",\n        \"secret\": \"YOUR_ERP_TOKEN\"\n      },\n      \"headers\": {\n        \"X-Tenant\": \"acme\"\n      },\n      \"enabled\": true,\n      \"key\": \"erp\"\n    }\n  ],\n  \"forms\": [\n    {\n      \"key\": \"quote\",\n      \"name\": \"Quote request\",\n      \"definition\": {\n        \"title\": \"Quote request\",\n        \"description\": \"Tell us what you need and we will send a price.\",\n        \"prefix\": \"QR\",\n        \"steps\": [\n          {\n            \"key\": \"need\",\n            \"title\": \"What you need\",\n            \"text\": \"\",\n            \"show_if\": null,\n            \"fields\": [\n              {\n                \"key\": \"product\",\n                \"type\": \"select\",\n                \"label\": \"Product\",\n                \"required\": true,\n                \"list\": \"products\"\n              },\n              {\n                \"key\": \"quantity\",\n                \"type\": \"number\",\n                \"label\": \"How many?\",\n                \"required\": true,\n                \"min\": 1,\n                \"max\": 10000,\n                \"decimals\": 0\n              },\n              {\n                \"key\": \"notes\",\n                \"type\": \"textarea\",\n                \"label\": \"Anything we should know?\",\n                \"required\": false,\n                \"max_length\": 1000\n              },\n              {\n                \"key\": \"photos\",\n                \"type\": \"photo\",\n                \"label\": \"Photos of the site (optional)\",\n                \"required\": false,\n                \"max_files\": 3,\n                \"source\": \"any\"\n              },\n              {\n                \"key\": \"quote_amount\",\n                \"type\": \"number\",\n                \"label\": \"Quote amount\",\n                \"internal\": true,\n                \"decimals\": 2,\n                \"unit\": \"USD\"\n              }\n            ]\n          },\n          {\n            \"key\": \"delivery\",\n            \"title\": \"Delivery\",\n            \"text\": \"\",\n            \"show_if\": null,\n            \"fields\": [\n              {\n                \"key\": \"deliver\",\n                \"type\": \"yesno\",\n                \"label\": \"Do you need delivery?\",\n                \"required\": true\n              }\n            ]\n          },\n          {\n            \"key\": \"delivery_address\",\n            \"title\": \"Delivery address\",\n            \"text\": \"\",\n            \"show_if\": {\n              \"field\": \"deliver\",\n              \"equals\": true\n            },\n            \"fields\": [\n              {\n                \"key\": \"address\",\n                \"type\": \"textarea\",\n                \"label\": \"Where should we deliver?\",\n                \"required\": true,\n                \"max_length\": 300\n              }\n            ]\n          }\n        ],\n        \"stages\": [\n          {\n            \"key\": \"new\",\n            \"name\": \"New\",\n            \"kind\": \"open\",\n            \"color\": \"blue\",\n            \"set_by\": [],\n            \"require_note\": false,\n            \"message\": \"\"\n          },\n          {\n            \"key\": \"quoted\",\n            \"name\": \"Quoted\",\n            \"kind\": \"open\",\n            \"color\": \"amber\",\n            \"set_by\": [],\n            \"require_note\": false,\n            \"message\": \"\"\n          },\n          {\n            \"key\": \"accepted\",\n            \"name\": \"Accepted\",\n            \"kind\": \"done\",\n            \"color\": \"green\",\n            \"set_by\": [],\n            \"require_note\": false,\n            \"message\": \"Thank you. We will be in touch about {reference} shortly.\"\n          },\n          {\n            \"key\": \"declined\",\n            \"name\": \"Declined\",\n            \"kind\": \"cancelled\",\n            \"color\": \"grey\",\n            \"set_by\": [],\n            \"require_note\": false,\n            \"message\": \"\"\n          }\n        ],\n        \"trigger\": {\n          \"words\": [\n            \"quote\"\n          ],\n          \"header\": \"\",\n          \"body\": \"Tap the button to ask for a quote.\",\n          \"button\": \"Get a quote\",\n          \"footer\": \"\"\n        },\n        \"after\": {\n          \"review_step\": true,\n          \"reply\": \"Thanks {contact.name}. Your request {reference} is with us; the price follows shortly.\",\n          \"allow_additions\": true,\n          \"status_page\": true\n        },\n        \"calculated\": [\n          {\n            \"key\": \"estimate\",\n            \"label\": \"Estimate\",\n            \"formula\": \"quantity * lookup('products', product, 'price')\",\n            \"unit\": \"USD\",\n            \"decimals\": 2\n          }\n        ]\n      }\n    }\n  ],\n  \"automations\": [\n    {\n      \"name\": \"Price a quote request in the ERP\",\n      \"form\": \"quote\",\n      \"enabled\": true,\n      \"trigger\": \"submitted\",\n      \"options\": {},\n      \"conditions\": {\n        \"all\": [\n          {\n            \"field\": \"quantity\",\n            \"gt\": 0\n          }\n        ]\n      },\n      \"actions\": [\n        {\n          \"type\": \"http\",\n          \"connection\": \"erp\",\n          \"method\": \"POST\",\n          \"path\": \"/quotes\",\n          \"query\": {},\n          \"headers\": {\n            \"X-Source\": \"whatsapp\"\n          },\n          \"body\": {\n            \"reference\": \"{reference}\",\n            \"customer\": {\n              \"name\": \"{contact.name}\",\n              \"phone\": \"{contact.phone}\"\n            },\n            \"product\": \"{product}\",\n            \"quantity\": \"{quantity}\",\n            \"photos\": \"{files.photos}\"\n          },\n          \"save\": {\n            \"erp_id\": \"$.id\",\n            \"quote_amount\": \"$.total\"\n          },\n          \"on_fail\": \"retry\"\n        },\n        {\n          \"type\": \"set_status\",\n          \"status\": \"quoted\",\n          \"note\": \"Priced by the ERP\"\n        },\n        {\n          \"type\": \"reply\",\n          \"text\": \"Your quote {reference}: {quote_amount} USD for {quantity} x {product}. Shall we go ahead?\",\n          \"buttons\": [\n            {\n              \"id\": \"accept\",\n              \"title\": \"Accept\",\n              \"set_status\": \"accepted\"\n            },\n            {\n              \"id\": \"decline\",\n              \"title\": \"Decline\",\n              \"set_status\": \"declined\"\n            }\n          ],\n          \"file\": \"\",\n          \"link\": true\n        }\n      ]\n    },\n    {\n      \"name\": \"Tell the owner when a quote is accepted\",\n      \"form\": \"quote\",\n      \"enabled\": true,\n      \"trigger\": \"status_changed\",\n      \"options\": {\n        \"to\": [\n          \"accepted\"\n        ],\n        \"from\": []\n      },\n      \"conditions\": null,\n      \"actions\": [\n        {\n          \"type\": \"email\",\n          \"to\": [\n            \"owner\"\n          ],\n          \"subject\": \"Quote {reference} accepted: {quote_amount} USD\",\n          \"body\": \"{contact.name} ({contact.phone}) accepted.\\n\\n{answers}\\n\\n{desk_link}\",\n          \"attach_files\": false\n        }\n      ]\n    }\n  ],\n  \"publish\": [\n    \"quote\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The ready-made setups (presets), or one complete preset",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/presets?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "presets"
              ],
              "query": [
                {
                  "key": "key",
                  "value": "quote",
                  "description": "One preset's key: the answer then has key and preset, the complete setup document.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `submissions:manage`. The presets, each with key, name, description and category (Customers or Field staff): quote, application, documents, meter_reading, problem_report, contact_request, complaint, maintenance, feedback, job_completed, proof_of_delivery, expense, inspection, incident, leave_request. Each is a complete setup document (a form with stages, the lists it needs and the automations that go with it). `?key=` returns that one as `preset`: read it, change what you need and send it to POST /submit/setup; or send `{\"preset\": \"<key>\"}` there to install it as it is. An unknown key answers 400 `invalid_setup`.\n\nhttps://www.app2email.com/docs/api/submit-info/list-submit-presets"
          },
          "response": []
        },
        {
          "name": "The forms of the number",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/forms",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "forms"
              ]
            },
            "description": "Scope: `submissions:manage`. Every form with its key, name, whether it is enabled, archived and published, whether the working copy differs from the published version (`changed`), its state on WhatsApp, its links and how many submissions it has. Definitions are left out: GET /submit/forms/{key} has one form's definition and fields.\n\nhttps://www.app2email.com/docs/api/submit-info/list-forms"
          },
          "response": []
        },
        {
          "name": "Create a form from a definition or a preset",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/forms",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "forms"
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Send `name` and `definition` (the SubmitFormDefinition schema explains every key; a minimal form is a title and one step with one field). `name` alone makes a starter form with one question to change. `preset` installs a ready-made solution instead: its form with the lists and automations that belong to it (`applied` in the answer names them). The definition is checked as a whole: 400 `invalid_form` lists every problem with its path (`definition.steps[0].fields[1].label`) and a fix, and nothing is saved. The answer is the form with its normalized definition and its links. The web page works at once; to open the form inside WhatsApp call POST /submit/forms/{key}/publish next. A number has at most 100 forms.\n\nhttps://www.app2email.com/docs/api/submit-info/create-form",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"key\": \"meter_reading\",\n  \"name\": \"Meter reading\",\n  \"definition\": {\n    \"title\": \"Meter reading\",\n    \"description\": \"Send us this month's reading.\",\n    \"prefix\": \"MR\",\n    \"steps\": [\n      {\n        \"key\": \"reading\",\n        \"title\": \"Your reading\",\n        \"text\": \"\",\n        \"show_if\": null,\n        \"fields\": [\n          {\n            \"key\": \"meter_no\",\n            \"type\": \"text\",\n            \"label\": \"Meter number\",\n            \"help\": \"On the front of the meter\",\n            \"required\": true,\n            \"default\": \"{contact.meter_no}\",\n            \"max_length\": 20\n          },\n          {\n            \"key\": \"reading\",\n            \"type\": \"number\",\n            \"label\": \"Meter reading\",\n            \"required\": true,\n            \"min\": 0,\n            \"max\": 999999,\n            \"decimals\": 0,\n            \"unit\": \"kWh\"\n          },\n          {\n            \"key\": \"photo\",\n            \"type\": \"photo\",\n            \"label\": \"Photo of the meter\",\n            \"required\": true,\n            \"max_files\": 1,\n            \"source\": \"camera\"\n          },\n          {\n            \"key\": \"moving\",\n            \"type\": \"yesno\",\n            \"label\": \"Are you moving out?\",\n            \"required\": true\n          },\n          {\n            \"key\": \"billing_ref\",\n            \"type\": \"text\",\n            \"label\": \"Billing reference\",\n            \"internal\": true\n          }\n        ]\n      },\n      {\n        \"key\": \"move\",\n        \"title\": \"Your move\",\n        \"text\": \"We will close the account on that day.\",\n        \"show_if\": {\n          \"field\": \"moving\",\n          \"equals\": true\n        },\n        \"fields\": [\n          {\n            \"key\": \"move_date\",\n            \"type\": \"date\",\n            \"label\": \"Moving date\",\n            \"required\": true,\n            \"min_days\": -30,\n            \"max_days\": 90\n          },\n          {\n            \"key\": \"new_address\",\n            \"type\": \"textarea\",\n            \"label\": \"New address for the final bill\",\n            \"required\": false,\n            \"max_length\": 300\n          }\n        ]\n      }\n    ],\n    \"stages\": [\n      {\n        \"key\": \"received\",\n        \"name\": \"Received\",\n        \"kind\": \"open\",\n        \"color\": \"blue\",\n        \"set_by\": [],\n        \"require_note\": false,\n        \"message\": \"\"\n      },\n      {\n        \"key\": \"queried\",\n        \"name\": \"Queried\",\n        \"kind\": \"open\",\n        \"color\": \"amber\",\n        \"set_by\": [],\n        \"require_note\": true,\n        \"message\": \"We have a question about your reading {reference}: {note}\"\n      },\n      {\n        \"key\": \"checked\",\n        \"name\": \"Checked\",\n        \"kind\": \"done\",\n        \"color\": \"green\",\n        \"set_by\": [\n          \"manager\"\n        ],\n        \"require_note\": false,\n        \"message\": \"Thanks {contact.name}, your reading of {reading} kWh is recorded.\"\n      }\n    ],\n    \"who\": {\n      \"mode\": \"anyone\",\n      \"numbers\": [],\n      \"tag\": \"\"\n    },\n    \"trigger\": {\n      \"words\": [\n        \"meter\",\n        \"reading\"\n      ],\n      \"header\": \"\",\n      \"body\": \"Tap the button to send your reading.\",\n      \"button\": \"Open form\",\n      \"footer\": \"\"\n    },\n    \"after\": {\n      \"review_step\": true,\n      \"reply\": \"Thanks {contact.name}. We have your {form} - reference {reference}.\",\n      \"allow_additions\": false,\n      \"status_page\": true\n    },\n    \"web\": {\n      \"enabled\": true,\n      \"verify\": \"optional\",\n      \"ask_email\": false,\n      \"success_text\": \"\"\n    },\n    \"notify\": {\n      \"email\": true,\n      \"to\": [],\n      \"attach_files\": true\n    },\n    \"calculated\": [\n      {\n        \"key\": \"usage\",\n        \"label\": \"Usage\",\n        \"formula\": \"reading - previous('reading')\",\n        \"unit\": \"kWh\",\n        \"decimals\": 0\n      }\n    ],\n    \"retention_days\": 0\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "One form: definition, fields, links and WhatsApp state",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/forms/:key",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "forms",
                ":key"
              ],
              "variable": [
                {
                  "key": "key",
                  "value": "meter_reading",
                  "description": "The form's key (GET /submit/forms)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. The form's working definition with every default filled in, `fields` (every field and calculated value as a column: the keys to read in a submission's answers and extra), `links` (the web page, the wa.me link, the words), `published` and `changed` (does WhatsApp show the latest version?) and `flow` (Meta's status and complaints). Read it before changing a definition: PUT takes the whole definition back.\n\nhttps://www.app2email.com/docs/api/submit-info/get-form"
          },
          "response": []
        },
        {
          "name": "Change a form: name, on or off, archive, definition",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/forms/:key",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "forms",
                ":key"
              ],
              "variable": [
                {
                  "key": "key",
                  "value": "meter_reading",
                  "description": "The form's key (GET /submit/forms)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Any of `name`, `enabled`, `archived`, `position`, `definition` (400 `nothing_to_change` with none). A `definition` replaces the whole working copy, so read the form, change it and send all of it back; it is checked as a whole (400 `invalid_form`, nothing saved). The web page follows the saved definition. WhatsApp keeps showing the published version: call POST /submit/forms/{key}/publish to make a changed definition live there. Submissions already made keep their answers; a removed field stays readable in them.\n\nhttps://www.app2email.com/docs/api/submit-info/update-form",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"definition\": {\n    \"title\": \"Meter reading\",\n    \"description\": \"Send us this month's reading.\",\n    \"prefix\": \"MR\",\n    \"steps\": [\n      {\n        \"key\": \"reading\",\n        \"title\": \"Your reading\",\n        \"text\": \"\",\n        \"show_if\": null,\n        \"fields\": [\n          {\n            \"key\": \"meter_no\",\n            \"type\": \"text\",\n            \"label\": \"Meter number\",\n            \"help\": \"On the front of the meter\",\n            \"required\": true,\n            \"default\": \"{contact.meter_no}\",\n            \"max_length\": 20\n          },\n          {\n            \"key\": \"reading\",\n            \"type\": \"number\",\n            \"label\": \"Meter reading\",\n            \"required\": true,\n            \"min\": 0,\n            \"max\": 999999,\n            \"decimals\": 0,\n            \"unit\": \"kWh\"\n          },\n          {\n            \"key\": \"photo\",\n            \"type\": \"photo\",\n            \"label\": \"Photo of the meter\",\n            \"required\": true,\n            \"max_files\": 1,\n            \"source\": \"camera\"\n          },\n          {\n            \"key\": \"moving\",\n            \"type\": \"yesno\",\n            \"label\": \"Are you moving out?\",\n            \"required\": true\n          },\n          {\n            \"key\": \"billing_ref\",\n            \"type\": \"text\",\n            \"label\": \"Billing reference\",\n            \"internal\": true\n          }\n        ]\n      },\n      {\n        \"key\": \"move\",\n        \"title\": \"Your move\",\n        \"text\": \"We will close the account on that day.\",\n        \"show_if\": {\n          \"field\": \"moving\",\n          \"equals\": true\n        },\n        \"fields\": [\n          {\n            \"key\": \"move_date\",\n            \"type\": \"date\",\n            \"label\": \"Moving date\",\n            \"required\": true,\n            \"min_days\": -30,\n            \"max_days\": 90\n          },\n          {\n            \"key\": \"new_address\",\n            \"type\": \"textarea\",\n            \"label\": \"New address for the final bill\",\n            \"required\": false,\n            \"max_length\": 300\n          }\n        ]\n      }\n    ],\n    \"stages\": [\n      {\n        \"key\": \"received\",\n        \"name\": \"Received\",\n        \"kind\": \"open\",\n        \"color\": \"blue\",\n        \"set_by\": [],\n        \"require_note\": false,\n        \"message\": \"\"\n      },\n      {\n        \"key\": \"queried\",\n        \"name\": \"Queried\",\n        \"kind\": \"open\",\n        \"color\": \"amber\",\n        \"set_by\": [],\n        \"require_note\": true,\n        \"message\": \"We have a question about your reading {reference}: {note}\"\n      },\n      {\n        \"key\": \"checked\",\n        \"name\": \"Checked\",\n        \"kind\": \"done\",\n        \"color\": \"green\",\n        \"set_by\": [\n          \"manager\"\n        ],\n        \"require_note\": false,\n        \"message\": \"Thanks {contact.name}, your reading of {reading} kWh is recorded.\"\n      }\n    ],\n    \"who\": {\n      \"mode\": \"anyone\",\n      \"numbers\": [],\n      \"tag\": \"\"\n    },\n    \"trigger\": {\n      \"words\": [\n        \"meter\",\n        \"reading\"\n      ],\n      \"header\": \"\",\n      \"body\": \"Tap the button to send your reading.\",\n      \"button\": \"Open form\",\n      \"footer\": \"\"\n    },\n    \"after\": {\n      \"review_step\": true,\n      \"reply\": \"Thanks {contact.name}. We have your {form} - reference {reference}.\",\n      \"allow_additions\": false,\n      \"status_page\": true\n    },\n    \"web\": {\n      \"enabled\": true,\n      \"verify\": \"optional\",\n      \"ask_email\": false,\n      \"success_text\": \"\"\n    },\n    \"notify\": {\n      \"email\": true,\n      \"to\": [],\n      \"attach_files\": true\n    },\n    \"calculated\": [\n      {\n        \"key\": \"usage\",\n        \"label\": \"Usage\",\n        \"formula\": \"reading - previous('reading')\",\n        \"unit\": \"kWh\",\n        \"decimals\": 0\n      }\n    ],\n    \"retention_days\": 0\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete a form (archived when it has submissions)",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/forms/:key",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "forms",
                ":key"
              ],
              "variable": [
                {
                  "key": "key",
                  "value": "meter_reading",
                  "description": "The form's key (GET /submit/forms)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. A form without submissions is deleted, and its WhatsApp version is retired: form messages already sent stop opening. A form that has submissions is never deleted, because they belong to it: it is archived instead (no longer offered, its submissions stay) and the answer says `deleted` false, `archived` true with a note. PUT /submit/forms/{key} `{\"archived\": false}` brings an archived form back.\n\nhttps://www.app2email.com/docs/api/submit-info/delete-form"
          },
          "response": []
        },
        {
          "name": "Publish a form to WhatsApp",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/forms/:key/publish",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "forms",
                ":key",
                "publish"
              ],
              "variable": [
                {
                  "key": "key",
                  "value": "meter_reading",
                  "description": "The form's key (GET /submit/forms)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Builds the WhatsApp form from the saved definition, uploads it to Meta and publishes it. From then on the form's words, POST /submit/forms/{key}/send and the menu open it inside WhatsApp. Call it after creating a form and after every change of its definition. 400 `invalid_form` when the definition cannot be built into a WhatsApp form (the message says what to change). 409 `form_not_published` when the form is archived, the number's encryption key is not accepted by WhatsApp yet, or WhatsApp found problems in the generated form (`error.details.validation_errors` has them). 502 `whatsapp_flow_failed` when WhatsApp refused a call: try again in a minute. People who still have an older message keep the version it was sent with. A form that is not published still works through its web link.\n\nhttps://www.app2email.com/docs/api/submit-info/publish-form"
          },
          "response": []
        },
        {
          "name": "Send a form to a contact, with values filled in",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/forms/:key/send",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "forms",
                ":key",
                "send"
              ],
              "variable": [
                {
                  "key": "key",
                  "value": "meter_reading",
                  "description": "The form's key (GET /submit/forms)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Sends the form to one contact, with `prefill` values you already know (a job number, an account, the documents wanted). The WhatsApp form goes out when the form is published and the contact wrote to the number in the last 24 hours; a form that is not published goes out as a message with a button to the contact's personal web link. Outside the 24 hour window, or when a form message went to the contact less than 2 minutes ago, nothing is sent: the answer is still 200 with `sent` false and `note` saying why. `link` is always returned: when nothing was sent, send it yourself, for example in an approved template. `link_only` true sends nothing and just returns the link. `parent` makes the new submission a follow-up of an earlier one. The answers arrive as `submission.created`. 403 `submit_not_enabled` while Submit-Info is switched off; 409 `form_not_published` when the form is switched off or archived; 403 `recipient_opted_out` when the contact asked not to be messaged.\n\nhttps://www.app2email.com/docs/api/submit-info/send-form",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"to\": \"61412345678\",\n  \"name\": \"John Smith\",\n  \"prefill\": {\n    \"meter_no\": \"A-1182\"\n  },\n  \"text\": \"Hello John, please send this month's reading.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The choice lists (sites, jobs, price lists)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/lists",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "lists"
              ]
            },
            "description": "Scope: `submissions:manage`. Lists hold choices outside the forms. A select field with `list` set to a list's key shows its items, read fresh each time the form opens, so a list can change every day without publishing anything. Formulas read the other columns of an item: `lookup('products', product, 'price')`.\n\nhttps://www.app2email.com/docs/api/submit-info/list-submit-lists"
          },
          "response": []
        },
        {
          "name": "Create a list or replace its items",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/lists/:key",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "lists",
                ":key"
              ],
              "variable": [
                {
                  "key": "key",
                  "value": "products",
                  "description": "The list's key: lower case letters, digits and _, starting with a letter."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Makes the list when the key is new; otherwise replaces its name and ALL its items (send the full list every time, for example from a nightly sync of jobs or prices). Each item needs a unique `id` (stored as the answer) and a `title` (what people see; left out, the id); any other key is a column for formulas. A plain text instead of an object is an item whose id and title are that text. Up to 1,000 items and 200 KB; a form shows the first 200. Forms pick the change up at once: no publish is needed. A number has at most 50 lists.\n\nhttps://www.app2email.com/docs/api/submit-info/set-submit-list",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Products\",\n  \"items\": [\n    {\n      \"id\": \"pump-s\",\n      \"title\": \"Pump, small\",\n      \"description\": \"Up to 40 l/min\",\n      \"price\": 240\n    },\n    {\n      \"id\": \"pump-l\",\n      \"title\": \"Pump, large\",\n      \"description\": \"Up to 120 l/min\",\n      \"price\": 610\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete a list",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/lists/:key",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "lists",
                ":key"
              ],
              "variable": [
                {
                  "key": "key",
                  "value": "products",
                  "description": "The list's key: lower case letters, digits and _, starting with a letter."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. A select field that still names the list then shows one line, Nothing to choose, until the list is made again or the question is changed. `used_by` in the answer names those forms.\n\nhttps://www.app2email.com/docs/api/submit-info/delete-submit-list"
          },
          "response": []
        },
        {
          "name": "The submissions, filtered and paged (JSON or CSV)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/submissions?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "submissions"
              ],
              "query": [
                {
                  "key": "form",
                  "value": "meter_reading",
                  "description": "Only this form (its key). Several: keys with commas.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "received",
                  "description": "Only these stages: stage keys of the form, with commas.",
                  "disabled": true
                },
                {
                  "key": "status_kind",
                  "value": "open",
                  "description": "Only stages of this kind: open, done or cancelled (several with commas).",
                  "disabled": true
                },
                {
                  "key": "assignee",
                  "value": "12",
                  "description": "Only what these members hold: member ids with commas. 0 = not assigned.",
                  "disabled": true
                },
                {
                  "key": "priority",
                  "value": "high,urgent",
                  "description": "low, normal, high or urgent; several with commas.",
                  "disabled": true
                },
                {
                  "key": "tag",
                  "value": "north",
                  "description": "Only submissions with one of these tags (commas).",
                  "disabled": true
                },
                {
                  "key": "channel",
                  "value": "whatsapp",
                  "description": "whatsapp, web, api or staff; several with commas.",
                  "disabled": true
                },
                {
                  "key": "contact",
                  "value": "61412345678",
                  "description": "Only this person's (number with country code, or business-scoped user id).",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "A-1182",
                  "description": "The reference, a name or an answer contains this text.",
                  "disabled": true
                },
                {
                  "key": "created_from",
                  "value": "2026-11-01",
                  "description": "Created on or after this day (YYYY-MM-DD) or ISO 8601 time.",
                  "disabled": true
                },
                {
                  "key": "created_to",
                  "value": "2026-11-30",
                  "description": "Created up to and including this day (YYYY-MM-DD), or before this ISO 8601 time.",
                  "disabled": true
                },
                {
                  "key": "updated_after",
                  "value": "2026-11-13T04:00:00Z",
                  "description": "Changed after this ISO 8601 time: for syncing.",
                  "disabled": true
                },
                {
                  "key": "parent",
                  "value": "QR-4HT9XC",
                  "description": "Only the follow-ups of this submission (id or reference).",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "updated",
                  "description": "updated (default), created, due or priority; add _asc for the opposite order.",
                  "disabled": true
                },
                {
                  "key": "format",
                  "value": "json",
                  "description": "csv: a text/csv answer.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Latest change first; deleted ones are left out. Filter by form, stage (`status`, or `status_kind` open / done / cancelled), assignee, priority, tag, channel, contact, a search text, the creation time or the parent. `form`, `status`, `status_kind`, `assignee`, `priority`, `tag` and `channel` take several values with commas. To keep another system in step, poll with `updated_after` set to the largest `updated` you have seen and `sort=updated_asc`, or use the `submission.*` webhook events and skip polling. Page with `next_cursor` (the same filter and sort). `format=csv` (or the header `Accept: text/csv`) answers the same page as CSV, one column per field when one `form` is given; the next cursor is then in the header `X-Next-Cursor`. Lists leave out files and activity: GET /submit/submissions/{id} has them. A filter value that cannot be read answers 400 `invalid_submission` and names it; an unknown `parent` answers an empty list.\n\nhttps://www.app2email.com/docs/api/submit-info/list-submissions"
          },
          "response": []
        },
        {
          "name": "Create a submission from data you already hold",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/submissions",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "submissions"
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. For a system that already has the answers (a web shop, a call centre, an import). `form` is the form's key; `answers` are checked exactly like a customer's (required fields, ranges, choice ids: 400 `invalid_submission` names each field in `error.details`); `extra` fills internal fields; `files` attach base64 files to photo and document fields (up to 20 in one request, 10 MB each); `assignee` and `location` are optional. The submission gets a reference, starts in the form's first stage (or `status`), has channel `api`, and runs the form's automations like any other. No message is sent to the contact by this call itself; the form's automations may send one. `submission.created` is sent. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again.\n\nhttps://www.app2email.com/docs/api/submit-info/create-submission",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"form\": \"meter_reading\",\n  \"contact\": \"61412345678\",\n  \"contact_name\": \"John Smith\",\n  \"answers\": {\n    \"meter_no\": \"A-1182\",\n    \"reading\": 48213,\n    \"moving\": false\n  },\n  \"extra\": {\n    \"billing_ref\": \"R-88231\"\n  },\n  \"files\": [\n    {\n      \"field\": \"photo\",\n      \"name\": \"meter.jpg\",\n      \"mime\": \"image/jpeg\",\n      \"data\": \"/9j/4AAQSkZJRgABAQ...\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "One submission with files, activity and what can be done",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/submissions/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "submissions",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "MR-7Q3M2A",
                  "description": "The submission's id, or its reference (MR-7Q3M2A)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. By id or by reference. Everything about it: the answers and `extra`, `files` (each `url` fetches the bytes without a key for 7 days), `events` (the activity list: who did what, every note, reply and automation step), `fields` (how to label each answer), `stages` (where it can move, with `require_note`), `actions` (the manual automations to run with POST /submit/submissions/{id}/run) and `buttons` (sent to the submitter, not pressed yet). A deleted submission answers 404.\n\nhttps://www.app2email.com/docs/api/submit-info/get-submission"
          },
          "response": []
        },
        {
          "name": "Change a submission: stage, assignee, tags, answers",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/submissions/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "submissions",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "MR-7Q3M2A",
                  "description": "The submission's id, or its reference (MR-7Q3M2A)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Any of: `status` (a stage key; with `note` when the stage has `require_note`, else 409 `stage_not_allowed`), `priority`, `assignee` (a member id; 0 or null = nobody), `due` (null takes it off), `tags` / `tags_add` / `tags_remove`, `answers` and `extra` (only the keys given change, null removes one; calculated values are worked out again) and `location`. A `note` without `status` is written as an internal note. 400 `nothing_to_change` when the body names none of them; `changed` false when the submission already had these values. Each change is written to the activity list under the key's name. Moving to a stage sends that stage's `message` to the submitter, when it has one. Events: `submission.status_changed`, `submission.assigned`, `submission.updated`, `submission.note_added`, one per kind of change; the form's automations run on them.\n\nhttps://www.app2email.com/docs/api/submit-info/update-submission",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"status\": \"checked\",\n  \"note\": \"Matches the photo.\",\n  \"tags_add\": [\n    \"billed\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete a submission, or erase it for good",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/submissions/:id?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "submissions",
                ":id"
              ],
              "query": [
                {
                  "key": "erase",
                  "value": "false",
                  "description": "true: remove the rows and files for good.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "MR-7Q3M2A",
                  "description": "The submission's id, or its reference (MR-7Q3M2A)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Without `erase` the submission is hidden from every list and can be restored on the dashboard for 30 days; after that it is erased. With `erase=true` its rows, files and activity are removed now, for a privacy request: this cannot be undone, so confirm with the user first (erase also finds a submission that was deleted before). `submission.deleted` is sent, with `erased` saying which.\n\nhttps://www.app2email.com/docs/api/submit-info/delete-submission"
          },
          "response": []
        },
        {
          "name": "Write an internal note on a submission",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/submissions/:id/notes",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "submissions",
                ":id",
                "notes"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "MR-7Q3M2A",
                  "description": "The submission's id, or its reference (MR-7Q3M2A)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. A note for the team, up to 4,000 characters. The submitter never sees it. It appears in the activity list under the key's name, `submission.note_added` is sent, and automations with the trigger `note_added` run.\n\nhttps://www.app2email.com/docs/api/submit-info/add-submission-note",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"text\": \"The customer called: the meter was replaced in October.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Message the submitter, with up to 3 buttons",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/submissions/:id/reply",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "submissions",
                ":id",
                "reply"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "MR-7Q3M2A",
                  "description": "The submission's id, or its reference (MR-7Q3M2A)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Sends `text` to the person who made the submission: on WhatsApp, or by e-mail when they gave only an e-mail address (`by` says which). When WhatsApp cannot take a normal message for them right now the reply is held (`held` true): they get a short notice, and the reply the moment they tap it or write to the number, exactly as a reply from the Inbox. `buttons` (up to 3) let them answer with one tap: each can move the submission to a stage (`set_status`), which is how a quote is accepted or a fix confirmed; a press arrives as `submission.customer_replied`. `file` sends a document or picture with it, `link` adds a button to their status page. A web submission whose number was never confirmed is answered by e-mail only. The reply is in the activity list and on the submitter's status page. 403 `submit_not_enabled` while Submit-Info is switched off; 502 `whatsapp_error` when it could not be sent at all.\n\nhttps://www.app2email.com/docs/api/submit-info/reply-to-submission",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"text\": \"Is this still the right meter? The number on the photo is A-1128.\",\n  \"buttons\": [\n    {\n      \"id\": \"same\",\n      \"title\": \"Same meter\"\n    },\n    {\n      \"id\": \"new\",\n      \"title\": \"New meter\",\n      \"set_status\": \"queried\"\n    }\n  ],\n  \"link\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Attach a file to a submission",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/submissions/:id/files",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "submissions",
                ":id",
                "files"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "MR-7Q3M2A",
                  "description": "The submission's id, or its reference (MR-7Q3M2A)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. One file as base64, 10 MB at most (413 `media_too_large` above that): a report, a signed form, a photo taken later. With `field` it joins that photo or document field's files; without it, it is a loose file of the submission. The file type is worked out from the bytes, not from `mime`. A submission holds at most 60 files. `submission.updated` is sent with `change.files.added`, and automations with the trigger `file_added` run.\n\nhttps://www.app2email.com/docs/api/submit-info/add-submission-file",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"report.pdf\",\n  \"mime\": \"application/pdf\",\n  \"data\": \"JVBERi0xLjcKJcfsj6IK...\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Run a manual automation on a submission",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/submissions/:id/run",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "submissions",
                ":id",
                "run"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "MR-7Q3M2A",
                  "description": "The submission's id, or its reference (MR-7Q3M2A)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Runs one automation whose trigger is `manual` on this submission now: the same thing as its button in the inbox. `automation_id` is one of the submission's `actions[].id` (GET /submit/submissions/{id}); the automation must be switched on and belong to the submission's form (400 `invalid_automation` otherwise). The automation's conditions are still checked. The answer is the run with every step: what was sent to an outside system and what came back. A step that fails is inside the run (`steps[].ok` false, `status` failed), not an error of this call; when the server is busy the run is queued (`status` waiting) and shows in GET /submit/runs. Whatever the actions do is real: replies are sent, stages change, systems are called.\n\nhttps://www.app2email.com/docs/api/submit-info/run-submission-action",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"automation_id\": 31\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The team: who works in the shared inbox",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/members",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "members"
              ]
            },
            "description": "Scope: `submissions:manage`. The owner, the dashboard's members and the people invited to just the inbox, each with their role, what they may do now (`abilities`), which forms they see and how many open submissions they hold. A member's `id` is what `assignee` takes in PATCH /submit/submissions/{id} and what `member:<id>` means in an assign action.\n\nhttps://www.app2email.com/docs/api/submit-info/list-submit-members"
          },
          "response": []
        },
        {
          "name": "Invite a person to the shared inbox by e-mail",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/members",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "members"
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Sends an invitation e-mail with a link that works for 14 days. The person signs in (or makes a login) with that address and from then on sees the inbox, never the dashboard. `role` is a starting set of abilities (admin, manager, agent, viewer); `abilities` switches single ones on or off; `forms`, `own_only`, `see_unassigned` and `hide_contacts` narrow what they see. `email_sent` false means the e-mail could not go out: pass `invite_link` on yourself. An address that is a member already, or a full team (200 members), answers 400 `invalid_member`. Sends a real e-mail to a person: confirm the address with the user first.\n\nhttps://www.app2email.com/docs/api/submit-info/invite-submit-member",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"email\": \"sam@example.com\",\n  \"name\": \"Sam\",\n  \"role\": \"agent\",\n  \"abilities\": {\n    \"export\": true\n  },\n  \"forms\": []\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Change a member's role, abilities or forms",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/members/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "members",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "12",
                  "description": "The member's id (GET /submit/members)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Any of `name`, `role`, `abilities`, `forms`, `own_only`, `see_unassigned`, `hide_contacts`, `notify`; what is left out stays (400 `invalid_member` when the body names none). `abilities` replaces the member's own changes to the role's set: `{\"delete\": false}` takes one ability away from a manager. The owner's own row cannot be changed (400 `invalid_member`).\n\nhttps://www.app2email.com/docs/api/submit-info/update-submit-member",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"role\": \"manager\",\n  \"abilities\": {\n    \"delete\": false\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Remove a member from the inbox",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/members/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "members",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "12",
                  "description": "The member's id (GET /submit/members)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. The person loses access at once. What they did stays in the activity lists under their name, and what they hold stays assigned to their name until it is reassigned (PATCH /submit/submissions/{id} `assignee`). The owner cannot be removed (400 `invalid_member`).\n\nhttps://www.app2email.com/docs/api/submit-info/remove-submit-member"
          },
          "response": []
        },
        {
          "name": "The automations",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/automations?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "automations"
              ],
              "query": [
                {
                  "key": "form",
                  "value": "quote",
                  "description": "Only the automations of this form (its key).",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Every automation with its whole document, a one-sentence summary (`sentence`), how often it ran and failed, and its last error. `form` empty means it runs for every form.\n\nhttps://www.app2email.com/docs/api/submit-info/list-automations"
          },
          "response": []
        },
        {
          "name": "Create an automation: when, if, do",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/automations",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "automations"
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. `trigger` says when it runs (submitted, a stage change, a button the customer pressed, overdue, manual ...), `conditions` is a rule that must hold (or null), `actions` run in order: reply, e-mail, move the stage, assign, calculate, call an outside system through a connection and save parts of its answer, wait, and more. The SubmitAutomationInput schema lists every trigger, action, placeholder and formula function. The document is checked as a whole: 400 `invalid_automation` with each problem's path and a fix. Before switching one on, try it on a real submission with POST /submit/automations/try. A number has at most 200 automations.\n\nhttps://www.app2email.com/docs/api/submit-info/create-automation",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Price a quote request in the ERP\",\n  \"form\": \"quote\",\n  \"enabled\": true,\n  \"trigger\": \"submitted\",\n  \"options\": {},\n  \"conditions\": {\n    \"all\": [\n      {\n        \"field\": \"quantity\",\n        \"gt\": 0\n      }\n    ]\n  },\n  \"actions\": [\n    {\n      \"type\": \"http\",\n      \"connection\": \"erp\",\n      \"method\": \"POST\",\n      \"path\": \"/quotes\",\n      \"query\": {},\n      \"headers\": {\n        \"X-Source\": \"whatsapp\"\n      },\n      \"body\": {\n        \"reference\": \"{reference}\",\n        \"customer\": {\n          \"name\": \"{contact.name}\",\n          \"phone\": \"{contact.phone}\"\n        },\n        \"product\": \"{product}\",\n        \"quantity\": \"{quantity}\",\n        \"photos\": \"{files.photos}\"\n      },\n      \"save\": {\n        \"erp_id\": \"$.id\",\n        \"quote_amount\": \"$.total\"\n      },\n      \"on_fail\": \"retry\"\n    },\n    {\n      \"type\": \"set_status\",\n      \"status\": \"quoted\",\n      \"note\": \"Priced by the ERP\"\n    },\n    {\n      \"type\": \"reply\",\n      \"text\": \"Your quote {reference}: {quote_amount} USD for {quantity} x {product}. Shall we go ahead?\",\n      \"buttons\": [\n        {\n          \"id\": \"accept\",\n          \"title\": \"Accept\",\n          \"set_status\": \"accepted\"\n        },\n        {\n          \"id\": \"decline\",\n          \"title\": \"Decline\",\n          \"set_status\": \"declined\"\n        }\n      ],\n      \"file\": \"\",\n      \"link\": true\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Try an automation on a real submission, saving and sending nothing",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/automations/try",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "automations",
                "try"
              ]
            },
            "description": "Scope: `submissions:manage`. A sandbox key may use it. A rehearsal. Send the automation document (it need not be saved; the id of a saved one works too) and a real submission's id or reference of the same form: the conditions are evaluated and every action is prepared with that submission's values, so the answer shows each step with the filled-in texts and requests. Nothing is written to the submission and nothing is sent to the customer. With `call` true the http, openapi and mcp actions really call the outside system, so you can see its answer and check your `save` paths; without it their requests are only shown. A call that fails is a failed step inside the run, never an error of this route. The run of a try is not stored: its `id` is 0.\n\nhttps://www.app2email.com/docs/api/submit-info/try-automation",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"automation\": {\n    \"name\": \"Price a quote request in the ERP\",\n    \"form\": \"quote\",\n    \"enabled\": true,\n    \"trigger\": \"submitted\",\n    \"options\": {},\n    \"conditions\": {\n      \"all\": [\n        {\n          \"field\": \"quantity\",\n          \"gt\": 0\n        }\n      ]\n    },\n    \"actions\": [\n      {\n        \"type\": \"http\",\n        \"connection\": \"erp\",\n        \"method\": \"POST\",\n        \"path\": \"/quotes\",\n        \"query\": {},\n        \"headers\": {\n          \"X-Source\": \"whatsapp\"\n        },\n        \"body\": {\n          \"reference\": \"{reference}\",\n          \"customer\": {\n            \"name\": \"{contact.name}\",\n            \"phone\": \"{contact.phone}\"\n          },\n          \"product\": \"{product}\",\n          \"quantity\": \"{quantity}\",\n          \"photos\": \"{files.photos}\"\n        },\n        \"save\": {\n          \"erp_id\": \"$.id\",\n          \"quote_amount\": \"$.total\"\n        },\n        \"on_fail\": \"retry\"\n      },\n      {\n        \"type\": \"set_status\",\n        \"status\": \"quoted\",\n        \"note\": \"Priced by the ERP\"\n      },\n      {\n        \"type\": \"reply\",\n        \"text\": \"Your quote {reference}: {quote_amount} USD for {quantity} x {product}. Shall we go ahead?\",\n        \"buttons\": [\n          {\n            \"id\": \"accept\",\n            \"title\": \"Accept\",\n            \"set_status\": \"accepted\"\n          },\n          {\n            \"id\": \"decline\",\n            \"title\": \"Decline\",\n            \"set_status\": \"declined\"\n          }\n        ],\n        \"file\": \"\",\n        \"link\": true\n      }\n    ]\n  },\n  \"submission\": \"QR-4HT9XC\",\n  \"call\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "One automation",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/automations/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "automations",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "31",
                  "description": "The automation's id (GET /submit/automations)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. The whole document with its id, summary sentence and counters. Read it before changing it: PUT takes the whole document back.\n\nhttps://www.app2email.com/docs/api/submit-info/get-automation"
          },
          "response": []
        },
        {
          "name": "Change an automation, or switch it on or off",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/automations/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "automations",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "31",
                  "description": "The automation's id (GET /submit/automations)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Send the whole document (with `trigger` and `actions`) to replace it, or a body with neither of those to change only the keys it has: `{\"enabled\": false}` switches it off and keeps the rest. The result is checked as a whole (400 `invalid_automation`). Runs that are waiting (a `wait` action, a retry) continue with the new document.\n\nhttps://www.app2email.com/docs/api/submit-info/update-automation",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enabled\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete an automation",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/automations/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "automations",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "31",
                  "description": "The automation's id (GET /submit/automations)."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. It stops running, and its waiting runs are dropped. The run log of what it did stays for 30 days.\n\nhttps://www.app2email.com/docs/api/submit-info/delete-automation"
          },
          "response": []
        },
        {
          "name": "The automation run log, step by step",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/runs?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "runs"
              ],
              "query": [
                {
                  "key": "automation",
                  "value": "31",
                  "description": "Only this automation's runs (its id).",
                  "disabled": true
                },
                {
                  "key": "submission",
                  "value": "QR-4HT9XC",
                  "description": "Only the runs on this submission (id or reference).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "running",
                  "description": "Only this status.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Latest first, kept 30 days. Each run names its automation, submission and trigger and lists every step: the action, whether it worked, how long it took, and for outside calls the request that was sent and the start of the answer. Use `status=failed` to find what went wrong, `status=waiting` for runs paused by a wait or between retries. Page with `next_cursor`. An `automation` or `submission` filter that names nothing answers 404.\n\nhttps://www.app2email.com/docs/api/submit-info/list-automation-runs"
          },
          "response": []
        },
        {
          "name": "The connections to outside systems",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/connections",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "connections"
              ]
            },
            "description": "Scope: `submissions:manage`. The systems automations can call: plain HTTP APIs, APIs described by an OpenAPI document, and MCP servers. Each with its kind, address, sign-in type (`has_secret`, never the secret), how many operations or tools are known, the last time it worked, its last error and the automations that use it.\n\nhttps://www.app2email.com/docs/api/submit-info/list-connections"
          },
          "response": []
        },
        {
          "name": "Create or change a connection (HTTP, OpenAPI or MCP)",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/connections/:key",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "connections",
                ":key"
              ],
              "variable": [
                {
                  "key": "key",
                  "value": "erp",
                  "description": "The connection's key: lower case letters, digits and _, starting with a letter."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Makes the connection when the key is new (`name` and `kind` are needed then), else changes it: a body without `kind` changes only the keys it names. `kind` http: a base address and a sign-in. openapi: also `spec_url` (or `spec`), an OpenAPI 3 document in JSON. mcp: `base_url` is the MCP server's address. `auth.secret` is write-only: it is stored encrypted, never returned, and kept when a later PUT leaves it out (a changed address needs it again). Addresses must be https and public. Saving does not call the outside system: a posted `spec` is read into operations at once, a `spec_url` and an MCP server's tools are read by POST /submit/connections/{key}/refresh. Next: POST /submit/connections/{key}/test, then refresh (openapi, mcp) and GET /submit/connections/{key}/functions to see what an action can call. A number has at most 30 connections.\n\nhttps://www.app2email.com/docs/api/submit-info/set-connection",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"ERP\",\n  \"kind\": \"http\",\n  \"base_url\": \"https://erp.example.com/api\",\n  \"auth\": {\n    \"type\": \"bearer\",\n    \"secret\": \"YOUR_ERP_TOKEN\"\n  },\n  \"headers\": {\n    \"X-Tenant\": \"acme\"\n  },\n  \"enabled\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete a connection",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/connections/:key",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "connections",
                ":key"
              ],
              "variable": [
                {
                  "key": "key",
                  "value": "erp",
                  "description": "The connection's key: lower case letters, digits and _, starting with a letter."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. Refused while an automation still uses it: 409 `connection_in_use`, and the message names those automations. The stored secret is deleted with it.\n\nhttps://www.app2email.com/docs/api/submit-info/delete-connection"
          },
          "response": []
        },
        {
          "name": "Test a connection: can app2email reach it and sign in?",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/connections/:key/test",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "connections",
                ":key",
                "test"
              ],
              "variable": [
                {
                  "key": "key",
                  "value": "erp",
                  "description": "The connection's key: lower case letters, digits and _, starting with a letter."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. A sandbox key may use it. Makes one real call from app2email's server: http reads the base address, openapi fetches the document, mcp opens a session with the server. The answer says whether it worked (`ok`), how far it got (`stage`), the HTTP status, the error in words and the time taken. A failed test answers 200 with `ok` false: read `stage` and `error` (`stage` is `response` when it worked). Nothing is changed in the outside system.\n\nhttps://www.app2email.com/docs/api/submit-info/test-connection"
          },
          "response": []
        },
        {
          "name": "Read a connection's operations or tools again",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/connections/:key/refresh",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "connections",
                ":key",
                "refresh"
              ],
              "variable": [
                {
                  "key": "key",
                  "value": "erp",
                  "description": "The connection's key: lower case letters, digits and _, starting with a letter."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. Not with a sandbox key. For openapi: fetches the document again and rebuilds the list of operations. For mcp: asks the server for its tools again. Call it after the outside system changed. An automation that names an operation or tool that is gone fails at its next run, so check GET /submit/automations afterwards. 502 `connection_failed` when the document or the server cannot be read; the old list is kept then.\n\nhttps://www.app2email.com/docs/api/submit-info/refresh-connection"
          },
          "response": []
        },
        {
          "name": "What an action can call on a connection",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/connections/:key/functions",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "connections",
                ":key",
                "functions"
              ],
              "variable": [
                {
                  "key": "key",
                  "value": "erp",
                  "description": "The connection's key: lower case letters, digits and _, starting with a letter."
                }
              ]
            },
            "description": "Scope: `submissions:manage`. The operations of an openapi connection or the tools of an mcp connection, each with its parameters: name, where it goes (path, query, header, body), type and whether it is required. An openapi action takes a function's `id` as `operation` and fills `params` by name; an mcp action takes it as `tool` and fills `arguments`. An http connection has no functions: its actions name method and path themselves.\n\nhttps://www.app2email.com/docs/api/submit-info/list-connection-functions"
          },
          "response": []
        },
        {
          "name": "Submission counts by form, stage, day and assignee",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/submit/report?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "submit",
                "report"
              ],
              "query": [
                {
                  "key": "days",
                  "value": "30",
                  "description": "How many days back, 1 to 365. Default 30.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `submissions:manage`. The submissions made in the last `days` days (1 to 365, default 30) counted by form, by stage, by day (in the business time zone) and by assignee, with how many are open now and the average hours from submission to a closed stage. 400 `invalid_range` when `days` is not 1 to 365.\n\nhttps://www.app2email.com/docs/api/submit-info/get-submit-report"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Order-and-Pay",
      "description": "A product catalog with its own order page: customers order from WhatsApp or the web for pickup or delivery, pay online or at the counter, and collect with a QR code. Orders are managed in the dashboard and the counter app; these events tell your system what happens to an order.",
      "item": [
        {
          "name": "The shop: on or off, open now, the order page, counts and limits",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop"
              ]
            },
            "description": "Scope: `orders:manage`. Start here. `enabled` says whether the shop takes orders; `open_now` and `paused` what a customer would find right now; `page_url` is the public order page; `counts` and `limits` say how big the catalog is and may get (10,000 items, archived ones not counted). A number that never opened Order-and-Pay answers `set_up` false.\n\nhttps://www.app2email.com/docs/api/order-and-pay/get-shop"
          },
          "response": []
        },
        {
          "name": "Every setting of the shop, as the shop uses it",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/settings",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "settings"
              ]
            },
            "description": "Scope: `orders:manage`. `config` holds the sections with every value in force: `fulfilment` (pickup, delivery, opening hours, special days, the pause), `pickup` (preparation time, time slots), `delivery` (the options with areas and costs), `checkout` (minimum order, fees, tips, notes), `payments`, `discounts` (codes), `orders` (automatic acceptance), `notify` (e-mail addresses), `whatsapp` (the words that open the shop, how customers order, the order messages), and `business`, `money`, `tax`, `stock`, `catalog`. A value the shop never changed shows the default of its type.\n\nhttps://www.app2email.com/docs/api/order-and-pay/get-shop-settings"
          },
          "response": []
        },
        {
          "name": "Change settings of the shop",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/settings",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "settings"
              ]
            },
            "description": "Scope: `orders:manage`. Not with a sandbox key. Send `config` with the sections to change and, in each, only the keys to change: an object is merged key by key, a list replaces the stored list. Example: pause the shop for half an hour with `{\"config\": {\"fulfilment\": {\"pause_until\": \"2026-11-14T12:30:00Z\", \"pause_reason\": \"Kitchen is full\"}}}`. The whole result is checked before anything is saved: 400 `shop_invalid` names the first problem and `error.details.problems` all of them. The currency cannot change while the shop has items. The switch (`enabled`) and the order page's address are set in the dashboard, where they have their own checks. `not_ready` in the answer lists what still keeps the shop from taking orders.\n\nhttps://www.app2email.com/docs/api/order-and-pay/update-shop-settings",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"config\": {\n    \"fulfilment\": {\n      \"pause_until\": \"2026-11-14T12:30:00Z\",\n      \"pause_reason\": \"Kitchen is full\"\n    }\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The categories of the catalog",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/categories",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "categories"
              ]
            },
            "description": "Scope: `orders:manage`. Two levels at most (`parent_id`). `items` counts the items of each; `hidden` categories are not shown to customers.\n\nhttps://www.app2email.com/docs/api/order-and-pay/list-shop-categories"
          },
          "response": []
        },
        {
          "name": "Search and filter the products",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/items?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "items"
              ],
              "query": [
                {
                  "key": "q",
                  "value": "margherita",
                  "description": "Words to search for.",
                  "disabled": true
                },
                {
                  "key": "category",
                  "value": "3",
                  "description": "Only this category (its id).",
                  "disabled": true
                },
                {
                  "key": "tags",
                  "value": "vegetarian",
                  "description": "Only items with all of these tags, separated by commas.",
                  "disabled": true
                },
                {
                  "key": "price_min",
                  "value": "",
                  "description": "Lowest price, minor units.",
                  "disabled": true
                },
                {
                  "key": "price_max",
                  "value": "3000",
                  "description": "Highest price, minor units.",
                  "disabled": true
                },
                {
                  "key": "in_stock",
                  "value": "1",
                  "description": "1 = leave out what is sold out.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "active",
                  "description": "active (default), hidden, archived, or any (everything but archived).",
                  "disabled": true
                },
                {
                  "key": "stock",
                  "value": "low",
                  "description": "Only items in this stock state.",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "relevance",
                  "description": "relevance (default with q), manual (the shop's own order), price_asc, price_desc, newest, best, name.",
                  "disabled": true
                },
                {
                  "key": "facets",
                  "value": "1",
                  "description": "1 = add the counts per attribute value and tag.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "24",
                  "description": "How many (1 to 100, default 24).",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "0",
                  "description": "Skip this many.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `orders:manage`. The same search customers use: `q` finds words in the name, description, SKU and tags and tolerates typing mistakes (`typo_match` true). Filter by `category`, `tags`, a price range, `in_stock`, and any attribute with `attr.<key>=<value>` (eg `attr.colour=red,blue`). Without `status` only items customers can buy are listed; `status=any` adds hidden ones, `status=archived` lists the archive. Page with `limit` and `offset`; `total` stops counting at a few thousand (`total_capped`). `facets=1` adds the counts per attribute value, tag and the price range of the result. Variants and option groups are in GET /shop/items/{id}.\n\nhttps://www.app2email.com/docs/api/order-and-pay/list-shop-items"
          },
          "response": []
        },
        {
          "name": "Add a product",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/items",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "items"
              ]
            },
            "description": "Scope: `orders:manage`. Not with a sandbox key. The body is the item: `name` and `price` (minor units) are needed, everything else is optional. `variants` gives the versions of the item (size, colour), each with its `attrs`, optional `price` and own stock; `option_group_ids` links existing option groups (extras, choices). Customers see an `active` item at once. 409 `shop_sku_taken` when the SKU is in use, 409 `shop_limit` at 10,000 items. Pictures are added in the dashboard (or by an import with picture addresses).\n\nhttps://www.app2email.com/docs/api/order-and-pay/create-shop-item",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Margherita\",\n  \"price\": 1000,\n  \"sku\": \"PZ-MARG\",\n  \"category_id\": 3,\n  \"description\": \"Tomato, mozzarella, basil.\",\n  \"allergens\": [\n    \"gluten\",\n    \"milk\"\n  ],\n  \"option_group_ids\": [\n    10\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "One product with variants, option groups and pictures",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/items/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "items",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "12",
                  "description": "The item's id (GET /shop/items)."
                }
              ]
            },
            "description": "Scope: `orders:manage`. Everything needed to put the item in a cart: `variants` (an item with `has_variants` needs a `variant_id` in the cart line), `option_groups` with their choices, price changes and how many must and may be chosen, the stock of the item or of each variant, and `images`.\n\nhttps://www.app2email.com/docs/api/order-and-pay/get-shop-item"
          },
          "response": []
        },
        {
          "name": "Change a product: only the keys sent change",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/items/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "items",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "12",
                  "description": "The item's id (GET /shop/items)."
                }
              ]
            },
            "description": "Scope: `orders:manage`. Not with a sandbox key. Send the keys to change. `variants`, when sent, is the whole list: include the `id` of each variant to keep, leave one out to remove it. Stock figures are only written when the request names them (`stock_qty` of the item or of a variant); to change stock safely while orders come in use POST /shop/items/{id}/stock. `status` archived takes the item out of the catalog.\n\nhttps://www.app2email.com/docs/api/order-and-pay/update-shop-item",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"price\": 1100\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Archive a product",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/items/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "items",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "12",
                  "description": "The item's id (GET /shop/items)."
                }
              ]
            },
            "description": "Scope: `orders:manage`. Not with a sandbox key. The item is archived, not erased: orders keep their lines and the reports their figures. Archived items are not counted against the 10,000 item limit. PUT with `status` active brings it back.\n\nhttps://www.app2email.com/docs/api/order-and-pay/archive-shop-item"
          },
          "response": []
        },
        {
          "name": "Set or change the stock of a product",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/items/:id/stock",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "items",
                ":id",
                "stock"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "12",
                  "description": "The item's id (GET /shop/items)."
                }
              ]
            },
            "description": "Scope: `orders:manage`. Not with a sandbox key. `mode` set writes the figure, `mode` add changes it by `value` (negative takes away) in one step that cannot lose a sale happening at the same moment. For an item with variants send `variant_id`. Every change is written to the stock history with the key's name and the `note`. 409 `shop_not_tracked` when the item does not count stock: send `start_tracking` true to switch it on with this figure.\n\nhttps://www.app2email.com/docs/api/order-and-pay/set-shop-stock",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"mode\": \"add\",\n  \"value\": 24,\n  \"note\": \"Delivery from the supplier\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Mark a product sold out for a while, or back",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/items/:id/sold_out",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "items",
                ":id",
                "sold_out"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "12",
                  "description": "The item's id (GET /shop/items)."
                }
              ]
            },
            "description": "Scope: `orders:manage`. Not with a sandbox key. For items that do not count stock (a dish that ran out). `until`: `on` until switched back, `1h`, `2h`, `4h`, `today` (until the end of the shop's day), `off` to make it available again, or a later time. Customers see it greyed out or not at all, as the shop has chosen.\n\nhttps://www.app2email.com/docs/api/order-and-pay/set-shop-sold-out",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"until\": \"today\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The orders, newest first",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/orders?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "orders"
              ],
              "query": [
                {
                  "key": "group",
                  "value": "open",
                  "description": "open, new, waiting, done or cancelled. Left out: all.",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "SO-K7M2QX",
                  "description": "A reference, a customer's name or number.",
                  "disabled": true
                },
                {
                  "key": "before",
                  "value": "",
                  "description": "For the next page: next_before of the previous answer.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 100, default 50).",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `orders:manage`. `group` narrows the list: `open` (accepted, being prepared, ready, on the way, and new ones), `new` (waiting for the shop to accept), `waiting` (not paid or not confirmed yet), `done`, `cancelled`. `q` finds a reference, a name or a number. Lists leave out the lines: `items_text` says what was ordered in one line, GET /shop/orders/{id} has the rest. Page with `before` set to `next_before`. To follow orders without polling use the `order.*` webhook events.\n\nhttps://www.app2email.com/docs/api/order-and-pay/list-shop-orders"
          },
          "response": []
        },
        {
          "name": "Place an order for a customer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/orders",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "orders"
              ]
            },
            "description": "Scope: `orders:manage`. Not with a sandbox key. For a system or an agent that takes the order itself. The cart is priced from the shop's data as it is now, stock is taken in the same step, and the order appears in the dashboard and the counter app like any other (`source` api). You vouch for `contact`: the order counts as that customer's own, and they get the shop's order messages on WhatsApp (confirmation with the pickup QR code, ready, and so on) where those are switched on. `pay` later = at pickup or on delivery; `pay` online answers `checkout_url`: send it to the customer, the order is confirmed (and `order.created` sent) when it is paid. Send `expected_total` with the total the customer agreed to: a different total answers 409 `shop_changed` with the new quote in `error.details.quote`. 409 `shop_order_problems` lists what is in the way the same way. The `Idempotency-Key` header (or `client_key`) makes a retry safe: the same key answers the same order with `repeated` true and status 200.\n\nhttps://www.app2email.com/docs/api/order-and-pay/create-shop-order",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"lines\": [\n    {\n      \"item_id\": 12,\n      \"qty\": 2,\n      \"option_ids\": [\n        102\n      ]\n    },\n    {\n      \"item_id\": 14,\n      \"qty\": 1\n    }\n  ],\n  \"fulfilment\": \"pickup\",\n  \"contact\": \"61412345678\",\n  \"name\": \"Sample Contact\",\n  \"pay\": \"later\",\n  \"expected_total\": 3050\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "One order with lines, payment, next steps and history",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/orders/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "orders",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "SO-K7M2QX",
                  "description": "The order's id, or its reference (SO-K7M2QX)."
                }
              ]
            },
            "description": "Scope: `orders:manage`. By id or by reference. `lines` with the chosen variant and options, the money, the pickup or delivery details, `actions` (what POST /shop/orders/{id}/action accepts now), `can_refund` with `refundable`, and `events`: who did what and when, on which device, including the hand-over at the counter.\n\nhttps://www.app2email.com/docs/api/order-and-pay/get-shop-order"
          },
          "response": []
        },
        {
          "name": "Move an order on, change its time, cancel or decline it",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/orders/:id/action",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "orders",
                ":id",
                "action"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "SO-K7M2QX",
                  "description": "The order's id, or its reference (SO-K7M2QX)."
                }
              ]
            },
            "description": "Scope: `orders:manage`. Not with a sandbox key. `action`: `accept`, `preparing`, `ready`, `out_for_delivery`, `complete` (handed over or delivered), `time` with `minutes` (later, or negative for earlier), `cancel` or `reject` with a `reason`, `no_show` for a ready pickup that was never collected (it ends as not collected and counts as a no-show of that customer), and `hand_lines` with `lines` [{ `id`, `qty` }] to give some lines now and the rest later (only when the shop has switched on partial hand-over; the order stays open until `complete`). Only the steps in the order's `actions` are accepted; anything else answers 400 `shop_invalid`, and 409 `shop_changed` when someone else moved the order meanwhile. `cancel` and `reject` give the stock back (`restock` false keeps it) and, with `refund` true, refund a paid order; `notice` in the answer says when a refund did not go through. The customer is told on WhatsApp where the shop has that message switched on. The step is written to the order's history with the key's name.\n\nhttps://www.app2email.com/docs/api/order-and-pay/update-shop-order",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"action\": \"ready\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Refund an order that was paid online",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/orders/:id/refund",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "orders",
                ":id",
                "refund"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "SO-K7M2QX",
                  "description": "The order's id, or its reference (SO-K7M2QX)."
                }
              ]
            },
            "description": "Scope: `orders:manage`. Not with a sandbox key. In full when `amount` is left out, else that many minor units (at most `refundable`). The money goes back through the payment provider the way it was paid; an order paid at the counter cannot be refunded here. The order itself stays as it is: cancel it with POST /shop/orders/{id}/action when it should also end.\n\nhttps://www.app2email.com/docs/api/order-and-pay/refund-shop-order",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": 1000\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Price a cart: total, problems, times and ways to pay",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/quote",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "quote"
              ]
            },
            "description": "Scope: `orders:manage`. Nothing is saved and no stock is taken. `quote` has the lines with their prices, the discount (or why a code gives none), the delivery fee for the address, fees, tip, tax and `total`; `problems` lists what is in the way (empty = the order can be placed). `times` says whether as-soon-as-possible is offered and when it would be ready, and the time slots when the shop uses them; `pay` which ways to pay this order has. Quote first, show the total, then POST /shop/orders with `expected_total`.\n\nhttps://www.app2email.com/docs/api/order-and-pay/quote-shop-order",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"lines\": [\n    {\n      \"item_id\": 12,\n      \"qty\": 2,\n      \"option_ids\": [\n        102\n      ]\n    },\n    {\n      \"item_id\": 14,\n      \"qty\": 1\n    }\n  ],\n  \"fulfilment\": \"pickup\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The shop's figures for a range of days",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/report?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "report"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "2026-11-07",
                  "description": "First day, YYYY-MM-DD. Default: six days before to.",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "2026-11-13",
                  "description": "Last day, YYYY-MM-DD. Default: today.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `orders:manage`. Both days are included, in the shop's time zone; the default is the last 7 days and a range covers 366 days at most. Orders by state, sales, what was paid online and at the counter by cash and card, delivery fees, tips, discounts, tax and refunds, the best sellers, orders per hour and per day, the customers who spent most, the discount codes used, where the orders came from, and the hand-over log.\n\nhttps://www.app2email.com/docs/api/order-and-pay/get-shop-report"
          },
          "response": []
        },
        {
          "name": "A customer's personal link to the order page",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/shop/link",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "shop",
                "link"
              ]
            },
            "description": "Scope: `orders:manage`. The order page opened through this link knows the customer: their name, their last five delivery addresses and their orders are there, and an order placed needs no confirmation step. Valid for 7 days. It identifies the customer, so send it only to that customer (for example in a template message). `page_url` is the public page without the personal part.\n\nhttps://www.app2email.com/docs/api/order-and-pay/get-shop-order-link",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contact\": \"61412345678\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Broadcasts",
      "description": "Lists of numbers (API or Broadcast page): status, the result per number, scheduling and cancelling.",
      "item": [
        {
          "name": "Your latest broadcasts",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/broadcasts?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "broadcasts"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "20",
                  "description": "How many (1 to 100, default 20).",
                  "disabled": true
                }
              ]
            },
            "description": "Broadcasts sent through the API (several numbers) and from the Broadcast page, newest first.\n\nhttps://www.app2email.com/docs/api/broadcasts/list-broadcasts"
          },
          "response": []
        },
        {
          "name": "A broadcast's status and the result per number",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/broadcasts/:code",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "broadcasts",
                ":code"
              ],
              "variable": [
                {
                  "key": "code",
                  "value": "k3XbQ9rTzP2mWv7a1c9e",
                  "description": "broadcast.code from the send answer, or from GET /broadcasts."
                }
              ]
            },
            "description": "Counts and the result for each number, live while a background send runs.\n\nhttps://www.app2email.com/docs/api/broadcasts/get-broadcast"
          },
          "response": []
        },
        {
          "name": "A broadcast's result for each message, as CSV",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/broadcasts/:code/results.csv",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "broadcasts",
                ":code",
                "results.csv"
              ],
              "variable": [
                {
                  "key": "code",
                  "value": "k3XbQ9rTzP2mWv7a1c9e",
                  "description": "broadcast.code from the send answer, or from GET /broadcasts."
                }
              ]
            },
            "description": "One row per message: number, status, message_id, the time of each step, the reply and the error. Opens in a spreadsheet. Values that start with = + - or @ get a ' in front, so a spreadsheet does not run them as formulas.\n\nhttps://www.app2email.com/docs/api/broadcasts/get-broadcast-csv"
          },
          "response": []
        },
        {
          "name": "Cancel a scheduled or sending API broadcast",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/broadcasts/:code/cancel",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "broadcasts",
                ":code",
                "cancel"
              ],
              "variable": [
                {
                  "key": "code",
                  "value": "k3XbQ9rTzP2mWv7a1c9e",
                  "description": "broadcast.code from the send answer."
                }
              ]
            },
            "description": "Needs the 'messages:send' scope. A scheduled broadcast (send_at) is removed: nothing is sent (200). A broadcast that is sending now (API list, background or scheduled): the messages not yet handed to WhatsApp are not sent, those already sent stay sent (202, status cancelling). Broadcasts started from the dashboard, and finished ones, cannot be cancelled here (409 broadcast_not_cancellable). broadcast.completed is sent with data.status cancelled.\n\nhttps://www.app2email.com/docs/api/broadcasts/cancel-broadcast"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Contacts",
      "description": "Contacts with tags, custom fields and consent records, and segments (saved filters) to send to.",
      "item": [
        {
          "name": "Your contacts, newest first",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/contacts?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "contacts"
              ],
              "query": [
                {
                  "key": "q",
                  "value": "john",
                  "description": "Part of the name or number.",
                  "disabled": true
                },
                {
                  "key": "tag",
                  "value": "vip",
                  "description": "Only contacts with this tag.",
                  "disabled": true
                },
                {
                  "key": "consent",
                  "value": "",
                  "description": "true: with marketing consent. false: without.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "Filter by a search text, a tag, or consent. Page with `next_cursor`.\n\nhttps://www.app2email.com/docs/api/contacts/list-contacts"
          },
          "response": []
        },
        {
          "name": "Make or update contacts (one, or a list of up to 1000)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/contacts",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "contacts"
              ]
            },
            "description": "Needs the 'contacts:manage' scope. Upsert by identity (phone or business-scoped user id): the fields given replace, the ones left out stay. Custom fields merge. `consent` records consent with its evidence. Fires contact.updated for requests of up to 50 contacts.\n\nhttps://www.app2email.com/docs/api/contacts/upsert-contacts",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"phone\": \"61412345678\",\n  \"name\": \"John Smith\",\n  \"tags\": [\n    \"vip\"\n  ],\n  \"custom_fields\": {\n    \"first_name\": \"John\",\n    \"order_id\": \"1234\"\n  },\n  \"source\": \"crm\",\n  \"consent\": {\n    \"marketing\": true,\n    \"at\": \"2026-10-01T09:00:00Z\",\n    \"source\": \"web form\",\n    \"text\": \"Yes, send me offers on WhatsApp\",\n    \"evidence\": \"https://example.com/forms/123\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Import contacts from CSV or JSON (up to 5000 rows)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/contacts/import",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "contacts",
                "import"
              ]
            },
            "description": "Needs the 'contacts:manage' scope. `text/csv` with a header row: phone (or identity / number / mobile), name (or first_name + last_name), tags (separated by |), consent_marketing (yes/no), consent_source, consent_text, consent_evidence, consent_at, source; every other column becomes a custom field. Or `application/json` with a list of contacts as for POST /contacts. Rows with a problem are skipped and listed; the rest are saved.\n\nhttps://www.app2email.com/docs/api/contacts/import-contacts",
            "body": {
              "mode": "raw",
              "raw": "[\n  {\n    \"phone\": \"61412345678\",\n    \"name\": \"John Smith\",\n    \"tags\": [\n      \"vip\"\n    ],\n    \"custom_fields\": {\n      \"first_name\": \"John\",\n      \"order_id\": \"1234\"\n    },\n    \"source\": \"crm\",\n    \"consent\": {\n      \"marketing\": true,\n      \"at\": \"2026-10-01T09:00:00Z\",\n      \"source\": \"web form\",\n      \"text\": \"Yes, send me offers on WhatsApp\",\n      \"evidence\": \"https://example.com/forms/123\"\n    }\n  }\n]",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "All contacts as CSV",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/contacts/export.csv",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "contacts",
                "export.csv"
              ]
            },
            "description": "One row per contact with tags (separated by |), consent and custom fields (as JSON). Up to 50,000 rows.\n\nhttps://www.app2email.com/docs/api/contacts/export-contacts"
          },
          "response": []
        },
        {
          "name": "One contact",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/contacts/:identity",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "contacts",
                ":identity"
              ],
              "variable": [
                {
                  "key": "identity",
                  "value": "61412345678",
                  "description": "The contact's number (country code first), or their business-scoped user id."
                }
              ]
            },
            "description": "https://www.app2email.com/docs/api/contacts/get-contact"
          },
          "response": []
        },
        {
          "name": "Change a contact",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/contacts/:identity",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "contacts",
                ":identity"
              ],
              "variable": [
                {
                  "key": "identity",
                  "value": "61412345678",
                  "description": "The contact's number (country code first), or their business-scoped user id."
                }
              ]
            },
            "description": "Needs the 'contacts:manage' scope. The same fields as POST /contacts; only the ones given change.\n\nhttps://www.app2email.com/docs/api/contacts/update-contact",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"John Smith\",\n  \"tags\": [\n    \"vip\",\n    \"newsletter\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete a contact record",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/contacts/:identity?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "contacts",
                ":identity"
              ],
              "query": [
                {
                  "key": "booking_data",
                  "value": "erase",
                  "description": "erase: also erase the contact's booking data (appointments, notes, links, holds, poll votes, package and payment details). Left out: the appointments are kept.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "identity",
                  "value": "61412345678",
                  "description": "The contact's number (country code first), or their business-scoped user id."
                }
              ]
            },
            "description": "Needs the 'contacts:manage' scope. The Do Not Call list and the opt-ins are separate records and stay. The contact's appointments (and notes, payments, packages) are kept: add `booking_data=erase` to erase or anonymise them too (future confirmed appointments are cancelled without a message, every appointment loses the customer's name, number, e-mail and notes, and their notes, links, holds and poll votes are deleted; the answer then carries `booking_data_erased` with the counts, and `booking.customer.erased` is sent). That cannot be undone. With `booking_data=erase` the contact's ticket data is erased too (orders and tickets lose the name, number, email and answers; old ticket links stop working); the answer then carries `ticket_data_erased` with the counts and `ticket.buyer.erased` is sent. It is refused, with the reason in `note`, while the contact holds a valid ticket for a coming date.\n\nhttps://www.app2email.com/docs/api/contacts/delete-contact"
          },
          "response": []
        },
        {
          "name": "Record consent (or its withdrawal) with evidence",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/contacts/:identity/consent",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "contacts",
                ":identity",
                "consent"
              ],
              "variable": [
                {
                  "key": "identity",
                  "value": "61412345678",
                  "description": "The contact's number (country code first), or their business-scoped user id."
                }
              ]
            },
            "description": "Needs the 'contacts:manage' scope. Makes the contact when it is new. `marketing: false` records a withdrawal: add the contact to the Do Not Call list too. Fires contact.updated.\n\nhttps://www.app2email.com/docs/api/contacts/record-consent",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"marketing\": true,\n  \"source\": \"web form\",\n  \"text\": \"Yes, send me offers on WhatsApp\",\n  \"evidence\": \"https://example.com/forms/123\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Your segments (saved contact filters)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/segments",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "segments"
              ]
            },
            "description": "https://www.app2email.com/docs/api/contacts/list-segments"
          },
          "response": []
        },
        {
          "name": "Save a contact filter as a segment",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/segments",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "segments"
              ]
            },
            "description": "Needs the 'contacts:manage' scope. Up to 100 segments. Send to it with POST /messages `segment`.\n\nhttps://www.app2email.com/docs/api/contacts/create-segment",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"VIP, consented\",\n  \"filter\": {\n    \"tags_any\": [\n      \"vip\"\n    ],\n    \"consent_marketing\": true,\n    \"last_inbound_days\": 90\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "One segment, with how many contacts match now",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/segments/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "segments",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "12",
                  "description": "The segment's id, or its exact name."
                }
              ]
            },
            "description": "https://www.app2email.com/docs/api/contacts/get-segment"
          },
          "response": []
        },
        {
          "name": "Rename a segment or replace its filter",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/segments/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "segments",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "12",
                  "description": "The segment's id, or its exact name."
                }
              ]
            },
            "description": "Needs the 'contacts:manage' scope. A `filter` given replaces the whole filter.\n\nhttps://www.app2email.com/docs/api/contacts/update-segment",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"VIP, consented\",\n  \"filter\": {\n    \"tags_any\": [\n      \"vip\"\n    ],\n    \"consent_marketing\": true,\n    \"last_inbound_days\": 90\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete a segment (its contacts stay)",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/segments/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "segments",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "12",
                  "description": "The segment's id, or its exact name."
                }
              ]
            },
            "description": "Needs the 'contacts:manage' scope.\n\nhttps://www.app2email.com/docs/api/contacts/delete-segment"
          },
          "response": []
        },
        {
          "name": "The contacts a segment matches now",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/segments/:id/contacts?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "segments",
                ":id",
                "contacts"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "12",
                  "description": "The segment's id, or its exact name."
                }
              ]
            },
            "description": "https://www.app2email.com/docs/api/contacts/list-segment-contacts"
          },
          "response": []
        },
        {
          "name": "WhatsApp users this number blocked",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/blocked?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "blocked"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "WhatsApp's own block list of the number (not the Do Not Call list). Page with `next_cursor`.\n\nhttps://www.app2email.com/docs/api/contacts/list-blocked-users"
          },
          "response": []
        },
        {
          "name": "Block WhatsApp users",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/blocked",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "blocked"
              ]
            },
            "description": "They cannot message the number and it cannot message them. Up to 1000 per call; only users who wrote in the last 24 hours.\n\nhttps://www.app2email.com/docs/api/contacts/block-users",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"users\": [\n    \"61412345678\",\n    \"AU.13491208655302741918\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Unblock WhatsApp users",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/blocked",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "blocked"
              ]
            },
            "description": "Same body as blocking.\n\nhttps://www.app2email.com/docs/api/contacts/unblock-users",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"users\": [\n    \"61412345678\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Is a phone number on file for a business-scoped user id",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/contact-book/:bsuid",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "contact-book",
                ":bsuid"
              ],
              "variable": [
                {
                  "key": "bsuid",
                  "value": "US.13491208655302741918",
                  "description": "The business-scoped user id (from_user_id of a message.received event), eg US.13491208655302741918. Parent ids (.ENT.) are refused."
                }
              ]
            },
            "description": "WhatsApp's contact book (per business portfolio) keeps the numbers of users the business talked to, so webhooks include them. Never returns the number.\n\nhttps://www.app2email.com/docs/api/contacts/get-contact-book-entry"
          },
          "response": []
        },
        {
          "name": "Remove a business-scoped user id from the contact book",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/contact-book/:bsuid",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "contact-book",
                ":bsuid"
              ],
              "variable": [
                {
                  "key": "bsuid",
                  "value": "US.13491208655302741918",
                  "description": "The business-scoped user id (from_user_id of a message.received event), eg US.13491208655302741918. Parent ids (.ENT.) are refused."
                }
              ]
            },
            "description": "Later webhooks may then leave the number out (unless the user writes again).\n\nhttps://www.app2email.com/docs/api/contacts/delete-contact-book-entry"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Opt-ins",
      "description": "Records that people agreed to your messages, and the rule that requires them for marketing.",
      "item": [
        {
          "name": "Is the opt-in rule for marketing on?",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/optin",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "optin"
              ]
            },
            "description": "Needs the 'settings:manage' scope.\n\nhttps://www.app2email.com/docs/api/opt-ins/get-optin-setting"
          },
          "response": []
        },
        {
          "name": "Turn the opt-in rule for marketing on or off",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/optin",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "optin"
              ]
            },
            "description": "When on, MARKETING template messages are only sent to numbers with an opt-in record. Others are skipped (recipient_not_opted_in; a single recipient gets 403). Utility templates and replies are not affected. Off by default.\n\nhttps://www.app2email.com/docs/api/opt-ins/set-optin-setting",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"require_optin_for_marketing\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The opt-in records, or check one number",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/optins?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "optins"
              ],
              "query": [
                {
                  "key": "number",
                  "value": "61412345678",
                  "description": "Check only this number: opted_in true or false.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "100",
                  "description": "How many (1 to 200, default 100).",
                  "disabled": true
                },
                {
                  "key": "after",
                  "value": "61412345678",
                  "description": "The next_after of the previous page.",
                  "disabled": true
                }
              ]
            },
            "description": "Your own proof that people agreed to your messages (kept by app2email; nothing else uses it unless the opt-in rule is on). Needs the 'settings:manage' scope.\n\nhttps://www.app2email.com/docs/api/opt-ins/list-optins"
          },
          "response": []
        },
        {
          "name": "Record that people opted in",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/optins",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "optins"
              ]
            },
            "description": "Up to 1000 entries, all or nothing. A number already recorded is updated. Needs the 'settings:manage' scope.\n\nhttps://www.app2email.com/docs/api/opt-ins/add-optins",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numbers\": [\n    \"61412345678\",\n    {\n      \"number\": \"61498765432\",\n      \"name\": \"Mary\",\n      \"source\": \"web form\",\n      \"note\": \"ticked the box\",\n      \"at\": \"2026-10-01T00:00:00Z\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Remove an opt-in record",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/optins/:phone",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "optins",
                ":phone"
              ],
              "variable": [
                {
                  "key": "phone",
                  "value": "61412345678",
                  "description": "The number, with country code."
                }
              ]
            },
            "description": "Needs the 'settings:manage' scope.\n\nhttps://www.app2email.com/docs/api/opt-ins/remove-optin"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Do Not Call",
      "description": "Numbers marketing templates are not sent to.",
      "item": [
        {
          "name": "The Do Not Call list, or check one number",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/donotcall?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "donotcall"
              ],
              "query": [
                {
                  "key": "number",
                  "value": "61412345678",
                  "description": "Check only this number (with country code).",
                  "disabled": true
                }
              ]
            },
            "description": "The whole list, or with ?number= whether that number is on it.\n\nhttps://www.app2email.com/docs/api/do-not-call/list-do-not-call"
          },
          "response": []
        },
        {
          "name": "Add numbers to the Do Not Call list",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/donotcall",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "donotcall"
              ]
            },
            "description": "Up to 1000 numbers, with an optional name and note each. Numbers already on the list are left as they are. All or nothing: one invalid number, nothing is added.\n\nhttps://www.app2email.com/docs/api/do-not-call/add-do-not-call",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"numbers\": [\n    \"61412345678\",\n    {\n      \"number\": \"61498765432\",\n      \"name\": \"Mary\",\n      \"note\": \"Unsubscribed in our CRM\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Remove a number from the Do Not Call list",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/donotcall/:phone",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "donotcall",
                ":phone"
              ],
              "variable": [
                {
                  "key": "phone",
                  "value": "61412345678",
                  "description": "The number to remove, with country code."
                }
              ]
            },
            "description": "https://www.app2email.com/docs/api/do-not-call/remove-do-not-call"
          },
          "response": []
        },
        {
          "name": "Consent records, Do Not Call list and opt-ins as one CSV",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/compliance/export.csv",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "compliance",
                "export.csv"
              ]
            },
            "description": "Needs the 'dnc:manage' scope. One row per record with record_type (consent, do_not_call, opt_in), identity, name, status, time, source, text, note and evidence: the records the Spam Act 2003 expects you to be able to show.\n\nhttps://www.app2email.com/docs/api/do-not-call/export-compliance"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Approvals",
      "description": "Sends held by a key's approval gate, waiting for a person.",
      "item": [
        {
          "name": "Sends held for approval",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/approvals?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "approvals"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "pending",
                  "description": "pending (default) or all.",
                  "disabled": true
                }
              ]
            },
            "description": "Sends held by a key's approval gate (approval_above on the API key page): pending ones by default, `status=all` for the resolved and expired ones of the last 7 days too.\n\nhttps://www.app2email.com/docs/api/approvals/list-approvals"
          },
          "response": []
        },
        {
          "name": "Approve a held send: it is sent now",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/approvals/:id/approve",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "approvals",
                ":id",
                "approve"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "apr_a1b2c3d4e5f6g7h8",
                  "description": "The approval's id."
                }
              ]
            },
            "description": "Needs the 'messages:send' scope, from a key that is not a sandbox key. The stored request is run as a normal send (the Do Not Call list, the limits and the daily cap are checked again); `send` in the answer is the answer the original request would have got. Fires approval.resolved. A held send expires 48 hours after it was held.\n\nhttps://www.app2email.com/docs/api/approvals/approve-send"
          },
          "response": []
        },
        {
          "name": "Reject a held send: nothing is sent",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/approvals/:id/reject",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "approvals",
                ":id",
                "reject"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "apr_a1b2c3d4e5f6g7h8",
                  "description": "The approval's id."
                }
              ]
            },
            "description": "Needs the 'messages:send' scope. Fires approval.resolved.\n\nhttps://www.app2email.com/docs/api/approvals/reject-send"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Number",
      "description": "The number at WhatsApp: health, business profile, display name, username, QR codes, conversation starters, commerce.",
      "item": [
        {
          "name": "Number health: can it send, quality, limit, name status",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/health",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "health"
              ]
            },
            "description": "WhatsApp's health_status and the number's fields (quality, messaging limit, throughput, display name review, account mode). Kept 60 s.\n\nhttps://www.app2email.com/docs/api/number/get-number-health"
          },
          "response": []
        },
        {
          "name": "Turn WhatsApp's identity change check on or off",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/identity-check",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "identity-check"
              ]
            },
            "description": "On: webhooks carry identity_key_hash, and a send with recipient_identity_key_hash is only delivered while it matches (else failed, code 137000).\n\nhttps://www.app2email.com/docs/api/number/set-identity-check",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"enabled\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The WhatsApp business profile",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/profile",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "profile"
              ]
            },
            "description": "About, address, description, email, websites, vertical and the photo link, as WhatsApp users see them.\n\nhttps://www.app2email.com/docs/api/number/get-business-profile"
          },
          "response": []
        },
        {
          "name": "Change the WhatsApp business profile",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/profile",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "profile"
              ]
            },
            "description": "Fields left out stay as they are. Meta's own body (with messaging_product, profile_picture_handle) works unchanged.\n\nhttps://www.app2email.com/docs/api/number/update-business-profile",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"about\": \"Plants and flowers, delivered same day\",\n  \"websites\": [\n    \"https://luckyshrub.example\",\n    \"https://luckyshrub.example/shop\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Change the profile photo from a public link",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/profile/photo",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "profile",
                "photo"
              ]
            },
            "description": "app2email downloads the image (JPG or PNG, up to 5 MB; 640x640 px suggested) and uploads it to WhatsApp.\n\nhttps://www.app2email.com/docs/api/number/set-profile-photo",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"link\": \"https://luckyshrub.example/logo.png\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Submit a new display name for Meta's review",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/profile/display-name",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "profile",
                "display-name"
              ]
            },
            "description": "Answer 202. GET /health shows new_name_status. After approval, number.updated (change display_name, next_step reconnect): press Reconnect on the dashboard within 14 days.\n\nhttps://www.app2email.com/docs/api/number/set-display-name",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Lucky Shrub Florist\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Official Business Account (blue tick) status",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/profile/official-business-account",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "profile",
                "official-business-account"
              ]
            },
            "description": "The state of the number's Official Business Account request.\n\nhttps://www.app2email.com/docs/api/number/get-official-business-account"
          },
          "response": []
        },
        {
          "name": "Request an Official Business Account (blue tick)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/profile/official-business-account",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "profile",
                "official-business-account"
              ]
            },
            "description": "Answer 202. Meta decides on notability; supporting_links: 5 to 10 articles about the business.\n\nhttps://www.app2email.com/docs/api/number/request-official-business-account",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"business_website_url\": \"https://luckyshrub.example\",\n  \"primary_country_of_operation\": \"DE\",\n  \"primary_language\": \"de\",\n  \"supporting_links\": [\n    \"https://news.example/a\",\n    \"https://news.example/b\",\n    \"https://press.example/c\",\n    \"https://magazine.example/d\",\n    \"https://blog.example/e\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "India business compliance information",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/profile/india-compliance",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "profile",
                "india-compliance"
              ]
            },
            "description": "The legal entity, grievance officer and customer care contacts (numbers in India).\n\nhttps://www.app2email.com/docs/api/number/get-india-compliance"
          },
          "response": []
        },
        {
          "name": "Set the India business compliance information",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/profile/india-compliance",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "profile",
                "india-compliance"
              ]
            },
            "description": "Replaces it. Needed for numbers that message users in India.\n\nhttps://www.app2email.com/docs/api/number/set-india-compliance",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"entity_name\": \"Lucky Shrub Pvt Ltd\",\n  \"entity_type\": \"PRIVATE_COMPANY\",\n  \"grievance_officer_details\": {\n    \"name\": \"A. Rao\",\n    \"email\": \"grievance@luckyshrub.example\",\n    \"mobile_number\": \"+919812345678\"\n  },\n  \"customer_care_details\": {\n    \"email\": \"care@luckyshrub.example\",\n    \"landline_number\": \"+912212345678\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The business username",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/username",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "username"
              ]
            },
            "description": "status none: the number has no username.\n\nhttps://www.app2email.com/docs/api/number/get-username"
          },
          "response": []
        },
        {
          "name": "Adopt or change the business username",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/username",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "username"
              ]
            },
            "description": "3 to 35 characters of a-z, 0-9, '.', '_', with a letter. At most 2 changes in 14 days (422 username_change_limit).\n\nhttps://www.app2email.com/docs/api/number/set-username",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"username\": \"luckyshrub\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Remove the business username",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/username",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "username"
              ]
            },
            "description": "Removing does not reset the 14-day change limit.\n\nhttps://www.app2email.com/docs/api/number/delete-username"
          },
          "response": []
        },
        {
          "name": "Usernames reserved for the business",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/username/suggestions",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "username",
                "suggestions"
              ]
            },
            "description": "Reserved names have a higher chance of approval.\n\nhttps://www.app2email.com/docs/api/number/get-username-suggestions"
          },
          "response": []
        },
        {
          "name": "Ice breakers, commands and welcome message",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/conversation-starters",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "conversation-starters"
              ]
            },
            "description": "What WhatsApp users see when they open a chat or type '/'.\n\nhttps://www.app2email.com/docs/api/number/get-conversation-starters"
          },
          "response": []
        },
        {
          "name": "Set ice breakers, commands or the welcome message",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/conversation-starters",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "conversation-starters"
              ]
            },
            "description": "Replaces the parts given. A tap or a command arrives as a normal text message (forwarded by email as usual).\n\nhttps://www.app2email.com/docs/api/number/set-conversation-starters",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"prompts\": [\n    \"Track my order\",\n    \"Opening hours\"\n  ],\n  \"commands\": [\n    {\n      \"name\": \"order\",\n      \"description\": \"Where is my order?\"\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "QR codes and short links",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/qr-codes?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "qr-codes"
              ],
              "query": [
                {
                  "key": "image",
                  "value": "svg",
                  "description": "Also give each code's image link (qr_image_url) in this format.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer.",
                  "disabled": true
                }
              ]
            },
            "description": "Up to 2,000 per number. Codes never expire; WhatsApp gives no scan counts.\n\nhttps://www.app2email.com/docs/api/number/list-qr-codes"
          },
          "response": []
        },
        {
          "name": "Create a QR code and wa.me short link",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/qr-codes",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "qr-codes"
              ]
            },
            "description": "The chat opens with prefilled_message (up to 140 characters). Answer 201.\n\nhttps://www.app2email.com/docs/api/number/create-qr-code",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"prefilled_message\": \"Hi, I saw your poster\",\n  \"image\": \"png\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "One QR code",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/qr-codes/:code?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "qr-codes",
                ":code"
              ],
              "query": [
                {
                  "key": "image",
                  "value": "svg",
                  "description": "Also give each code's image link (qr_image_url) in this format.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "code",
                  "value": "4O4YGZEG3RIVE1",
                  "description": "The QR code's code (14 characters), as in the list."
                }
              ]
            },
            "description": "With ?image=svg or png, its image link too.\n\nhttps://www.app2email.com/docs/api/number/get-qr-code"
          },
          "response": []
        },
        {
          "name": "Change a QR code's prefilled message",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/qr-codes/:code",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "qr-codes",
                ":code"
              ],
              "variable": [
                {
                  "key": "code",
                  "value": "4O4YGZEG3RIVE1",
                  "description": "The QR code's code (14 characters), as in the list."
                }
              ]
            },
            "description": "The code, link and image stay the same.\n\nhttps://www.app2email.com/docs/api/number/update-qr-code",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"prefilled_message\": \"Hi, I saw your new poster\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete a QR code and its short link",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/qr-codes/:code",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "qr-codes",
                ":code"
              ],
              "variable": [
                {
                  "key": "code",
                  "value": "4O4YGZEG3RIVE1",
                  "description": "The QR code's code (14 characters), as in the list."
                }
              ]
            },
            "description": "Printed codes and shared links stop working.\n\nhttps://www.app2email.com/docs/api/number/delete-qr-code"
          },
          "response": []
        },
        {
          "name": "Cart and catalog icon on or off",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/commerce",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "commerce"
              ]
            },
            "description": "WhatsApp's defaults: cart on, catalog icon hidden.\n\nhttps://www.app2email.com/docs/api/number/get-commerce-settings"
          },
          "response": []
        },
        {
          "name": "Turn the cart or the catalog icon on or off",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/commerce",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "commerce"
              ]
            },
            "description": "One or both. Meta's is_cart_enabled / is_catalog_visible work too.\n\nhttps://www.app2email.com/docs/api/number/set-commerce-settings",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"catalog_visible\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The connected product catalog",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/catalog",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "catalog"
              ]
            },
            "description": "Connected to the WhatsApp Business Account, so to every number on it. null: none.\n\nhttps://www.app2email.com/docs/api/number/get-catalog"
          },
          "response": []
        },
        {
          "name": "Connect a product catalog",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/catalog",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "catalog"
              ]
            },
            "description": "A catalog from Commerce Manager; the WABA-wide link for product messages.\n\nhttps://www.app2email.com/docs/api/number/connect-catalog",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"catalog_id\": \"1043215907766185\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Settings",
      "description": "Auto reply, email forwarding, and the number's settings (email behaviour, caps, compliance).",
      "item": [
        {
          "name": "The auto reply to new contacts",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/autoreply",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "autoreply"
              ]
            },
            "description": "Needs the 'settings:manage' scope. The text of the first reply a new contact gets (the dashboard's Auto reply page).\n\nhttps://www.app2email.com/docs/api/settings/get-autoreply"
          },
          "response": []
        },
        {
          "name": "Change the auto reply text",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/autoreply",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "autoreply"
              ]
            },
            "description": "Text only: the image and attachment of the auto reply are set on the dashboard. 1 to 4000 characters.\n\nhttps://www.app2email.com/docs/api/settings/set-autoreply",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"text\": \"Thanks for writing! We reply within a day.\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Who gets the messages by email",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/forwarding",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "forwarding"
              ]
            },
            "description": "Needs the 'settings:manage' scope. The email addresses that get each WhatsApp message (the dashboard's Forward email page).\n\nhttps://www.app2email.com/docs/api/settings/get-forwarding"
          },
          "response": []
        },
        {
          "name": "Change who gets the messages by email",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/forwarding",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "forwarding"
              ]
            },
            "description": "Fields left out stay as they are. Up to 3 valid emails each for to, cc and bcc. WhatsApp-to-email forwarding works on the Professional and Trial plans (works_on_this_plan says whether it does for this number).\n\nhttps://www.app2email.com/docs/api/settings/set-forwarding",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"to\": [\n    \"a@x.com\"\n  ],\n  \"cc\": [],\n  \"bcc\": [],\n  \"text\": \"New WhatsApp message\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The number's settings: email behaviour, caps, compliance",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/number",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "number"
              ]
            },
            "description": "Every setting with its value (defaults filled in).\n\nhttps://www.app2email.com/docs/api/settings/get-number-settings"
          },
          "response": []
        },
        {
          "name": "Change some of the number's settings",
          "request": {
            "method": "PUT",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/settings/number",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "settings",
                "number"
              ]
            },
            "description": "Needs the 'settings:manage' scope. Only the keys given change; nested objects (`{\"email\": {\"mark_read_on_open\": true}}`) or dotted keys (`{\"email.mark_read_on_open\": true}`) both work. Not with a sandbox key.\n\nhttps://www.app2email.com/docs/api/settings/update-number-settings",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"email\": {\n    \"mark_read_on_open\": true,\n    \"include_history\": 3\n  },\n  \"caps\": {\n    \"monthly_messages\": 2000\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Webhooks",
      "description": "Events sent to your URL: https://www.app2email.com/docs/api/webhooks",
      "item": [
        {
          "name": "Your webhooks",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks"
              ]
            },
            "description": "With the result of the last delivery to each.\n\nhttps://www.app2email.com/docs/api/webhooks/list-webhooks"
          },
          "response": []
        },
        {
          "name": "Get events at your URL",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks"
              ]
            },
            "description": "Up to 5 per number. Every webhook gets every event: use the event's type to pick the ones you handle. The same URL again answers that webhook, turned on (200). The answer has the secret that signs every event. Optional: headers (custom headers) and format (app2email or meta).\n\nhttps://www.app2email.com/docs/api/webhooks/create-webhook",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://hooks.example.com/app2email\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "A sample of every event",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks/samples",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks",
                "samples"
              ]
            },
            "description": "Each event type (and ping) as a test of that type sends it: the real fields, with made-up values and \"test\": true. Needs the 'webhooks:manage' scope.\n\nhttps://www.app2email.com/docs/api/webhooks/webhook-samples"
          },
          "response": []
        },
        {
          "name": "Change a webhook: url, active, headers, format",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "Only what is given changes: url, active, headers (a header set to null is removed), format. `active: true` turns a webhook back on after it was switched off for failures (and clears the failure count). The same url as another webhook of the number: 409 webhook_url_in_use. Needs the 'webhooks:manage' scope.\n\nhttps://www.app2email.com/docs/api/webhooks/update-webhook",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://hooks.example.com/app2email\",\n  \"active\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete a webhook",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "Stops every delivery to it, planned retries included. Its delivery log is kept 7 days.\n\nhttps://www.app2email.com/docs/api/webhooks/delete-webhook"
          },
          "response": []
        },
        {
          "name": "Send a test event now",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks/:id/test",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks",
                ":id",
                "test"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "Sends a test event to the webhook's URL straight away (once, no retries, not in the delivery log) and answers how the URL responded. No body: a 'ping'. {\"type\": \"message.received\"}: that event's sample. {\"event\": {...}}: your own event. Test events carry \"test\": true and the header X-App2email-Test: true, and are signed like every event. Up to 30 tests an hour per number (429 too_many_tests). A webhook with format meta gets the event as Meta's own body.\n\nhttps://www.app2email.com/docs/api/webhooks/test-webhook",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"message.received\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Make a new signing secret",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks/:id/rotate-secret",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks",
                ":id",
                "rotate-secret"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "Events are signed with the new secret from then on; the old one stops working at once, unless keep_old_for_hours (1 to 24) is given: the old secret then also signs (a second v1= in X-App2email-Signature) until previous_secret_until. Needs the 'webhooks:manage' scope.\n\nhttps://www.app2email.com/docs/api/webhooks/rotate-webhook-secret",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"keep_old_for_hours\": 24\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The last deliveries, with every attempt",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks/:id/deliveries?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks",
                ":id",
                "deliveries"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 100, default 50).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "failed",
                  "description": "failed: never delivered. delivered: delivered.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "The events sent to this webhook in the last 7 days (the latest 100), newest first, each with its attempts. Use it to find what failed.\n\nhttps://www.app2email.com/docs/api/webhooks/list-webhook-deliveries"
          },
          "response": []
        },
        {
          "name": "One delivery, with the event as it was sent",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks/:id/deliveries/:event_id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks",
                ":id",
                "deliveries",
                ":event_id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                },
                {
                  "key": "event_id",
                  "value": "evt_Xq3k9m2",
                  "description": "The event's id (X-App2email-Delivery, or 'id' in the event)."
                }
              ]
            },
            "description": "Every try, and next_attempt_at while a retry is planned. event_body only with a key that also has messages:read.\n\nhttps://www.app2email.com/docs/api/webhooks/get-webhook-delivery"
          },
          "response": []
        },
        {
          "name": "Send a stored event again",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks/:id/deliveries/:event_id/redeliver",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks",
                ":id",
                "deliveries",
                ":event_id",
                "redeliver"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                },
                {
                  "key": "event_id",
                  "value": "evt_Xq3k9m2",
                  "description": "The event's id."
                }
              ]
            },
            "description": "The same event (same id, same body) is sent to the webhook's URL once, now, and the answer says how the URL responded. Needs the 'webhooks:manage' scope. An event that is being sent right now (its first try or a planned retry): 409 delivery_in_progress. Delivered: no more planned retries.\n\nhttps://www.app2email.com/docs/api/webhooks/redeliver-webhook-event"
          },
          "response": []
        },
        {
          "name": "Fetch events (no webhook address needed)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/events?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "events"
              ],
              "query": [
                {
                  "key": "after",
                  "value": "ec_184467",
                  "description": "The `cursor` of the previous answer, unchanged. Left out: from the oldest event still kept. `now`: only events from this moment on.",
                  "disabled": true
                },
                {
                  "key": "wait",
                  "value": "0",
                  "description": "Seconds to wait for an event when there is none yet (0 to 25). 0, the default, answers at once.",
                  "disabled": true
                },
                {
                  "key": "types",
                  "value": "message.received,message.status",
                  "description": "Only these event types, comma separated. Left out: every event.",
                  "disabled": true
                },
                {
                  "key": "from",
                  "value": "61412345678",
                  "description": "Only events of this contact (data.from, data.to, data.contact or data.number): full number, digits, with country code.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 100).",
                  "disabled": true
                }
              ]
            },
            "description": "The number's events, fetched instead of pushed: for an agent or a script with no public address for a webhook. Every event is the JSON a webhook gets (https://www.app2email.com/docs/api/webhooks), with the same id, oldest first. Keep the `cursor` of each answer and pass it as `after` on the next call; after a lost answer the same event can come again, so skip ids you have handled. `wait` holds the answer until an event arrives (long polling; one waiting call at a time is enough). The first call switches the number's feed on: events are kept from then on, for 72 hours (the newest 2,000), and the feed switches itself off after 7 days without a call. Webhooks keep working beside it.\n\nhttps://www.app2email.com/docs/api/webhooks/list-events"
          },
          "response": []
        },
        {
          "name": "Send a test event to any URL",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks/test-url",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks",
                "test-url"
              ]
            },
            "description": "One signed POST to any https URL, answered with the exact request sent and your URL's answer. No saved webhook needed. Shares the 30 tests an hour of the number (429 too_many_tests with Retry-After); 60 an hour per target host and per its IP address.\n\nhttps://www.app2email.com/docs/api/webhooks/test-webhook-url",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://hooks.example.com/app2email\",\n  \"type\": \"ping\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Your catchers",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks/catchers",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks",
                "catchers"
              ]
            },
            "description": "The number's catchers that have not expired.\n\nhttps://www.app2email.com/docs/api/webhooks/list-webhook-catchers"
          },
          "response": []
        },
        {
          "name": "Get a temporary URL that keeps what it receives",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks/catchers",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks",
                "catchers"
              ]
            },
            "description": "A URL for 1 hour that keeps up to 50 requests of up to 64 KB: use it as a webhook URL or in test-url, then read them. POST https://api.app2email.com/hooks/catch/{token} needs no key and answers 200 {\"ok\":true}; 404 unknown, 410 expired, 413 over 64 KB, 429 full. At most 3 per number at a time.\n\nhttps://www.app2email.com/docs/api/webhooks/create-webhook-catcher"
          },
          "response": []
        },
        {
          "name": "What a catcher received",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks/catchers/:token?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks",
                "catchers",
                ":token"
              ],
              "query": [
                {
                  "key": "after",
                  "value": "0",
                  "description": "Only the requests after this seq.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "Q7cT2mX9pLk3vB8nR1sWd4Fh6Jk0Zx2C",
                  "description": "The catcher's token."
                }
              ]
            },
            "description": "The requests, oldest first, with their headers and body. Poll with after = the last seq you have.\n\nhttps://www.app2email.com/docs/api/webhooks/get-webhook-catcher"
          },
          "response": []
        },
        {
          "name": "Delete a catcher",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/webhooks/catchers/:token",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "webhooks",
                "catchers",
                ":token"
              ],
              "variable": [
                {
                  "key": "token",
                  "value": "Q7cT2mX9pLk3vB8nR1sWd4Fh6Jk0Zx2C",
                  "description": "The catcher's token."
                }
              ]
            },
            "description": "Deletes it and what it received. Its URL answers 404 from then on.\n\nhttps://www.app2email.com/docs/api/webhooks/delete-webhook-catcher"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Analytics",
      "description": "WhatsApp's own figures: cost and volume, sent and delivered, the account's activity log, conversion events.",
      "item": [
        {
          "name": "WhatsApp cost and volume of this number",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/analytics/pricing?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "analytics",
                "pricing"
              ],
              "query": [
                {
                  "key": "since",
                  "value": "2026-10-01T00:00:00Z",
                  "description": "Start, ISO 8601. Default: 30 days before until. At most 1 year back.",
                  "disabled": true
                },
                {
                  "key": "until",
                  "value": "2026-11-01T00:00:00Z",
                  "description": "End, ISO 8601. Default: now.",
                  "disabled": true
                },
                {
                  "key": "granularity",
                  "value": "day",
                  "description": "Default day.",
                  "disabled": true
                },
                {
                  "key": "countries",
                  "value": "DE,AT",
                  "description": "Only these countries: comma separated 2-letter codes.",
                  "disabled": true
                },
                {
                  "key": "dimensions",
                  "value": "category,type,country",
                  "description": "Break down by: comma separated category, type, country, tier, phone. Default category,type.",
                  "disabled": true
                }
              ]
            },
            "description": "Meta's pricing_analytics for this number: delivered messages and their cost per period. Estimates, not the invoice.\n\nhttps://www.app2email.com/docs/api/analytics/get-pricing-analytics"
          },
          "response": []
        },
        {
          "name": "Messages sent and delivered, as WhatsApp counts them",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/analytics/messages?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "analytics",
                "messages"
              ],
              "query": [
                {
                  "key": "since",
                  "value": "2026-10-01T00:00:00Z",
                  "description": "Start, ISO 8601. Default: 30 days before until. At most 1 year back.",
                  "disabled": true
                },
                {
                  "key": "until",
                  "value": "2026-11-01T00:00:00Z",
                  "description": "End, ISO 8601. Default: now.",
                  "disabled": true
                },
                {
                  "key": "granularity",
                  "value": "day",
                  "description": "Default day.",
                  "disabled": true
                },
                {
                  "key": "countries",
                  "value": "DE,AT",
                  "description": "Only these countries: comma separated 2-letter codes.",
                  "disabled": true
                }
              ]
            },
            "description": "Meta's analytics for this number, per period.\n\nhttps://www.app2email.com/docs/api/analytics/get-message-analytics"
          },
          "response": []
        },
        {
          "name": "The WhatsApp Business Account's activity log",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/activity?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "activity"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "25",
                  "description": "How many (1 to 100, default 25).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer.",
                  "disabled": true
                }
              ]
            },
            "description": "Newest first: registrations, PIN and partner changes, billing, templates. Covers every number on the WABA.\n\nhttps://www.app2email.com/docs/api/analytics/get-account-activity"
          },
          "response": []
        },
        {
          "name": "The Conversions API dataset of the account",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/conversions/dataset",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "conversions",
                "dataset"
              ]
            },
            "description": "404 dataset_not_found: create it first.\n\nhttps://www.app2email.com/docs/api/analytics/get-conversions-dataset"
          },
          "response": []
        },
        {
          "name": "Create the Conversions API dataset",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/conversions/dataset",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "conversions",
                "dataset"
              ]
            },
            "description": "One per WhatsApp Business Account. Answer 201.\n\nhttps://www.app2email.com/docs/api/analytics/create-conversions-dataset",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"WhatsApp conversions\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Quality of the Conversions API dataset",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/conversions/dataset/quality?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "conversions",
                "dataset",
                "quality"
              ],
              "query": [
                {
                  "key": "fields",
                  "value": "web{event_match_quality{composite_score},event_name}",
                  "description": "Meta's field list, eg web{event_match_quality,event_name}.",
                  "disabled": true
                },
                {
                  "key": "agent_name",
                  "value": "",
                  "description": "Only the events a partner integration sent.",
                  "disabled": true
                }
              ]
            },
            "description": "Meta's dataset quality: event match quality, coverage, freshness. fields: Meta's field list (default: all of these).\n\nhttps://www.app2email.com/docs/api/analytics/get-conversions-dataset-quality"
          },
          "response": []
        },
        {
          "name": "Send conversion events of WhatsApp chats",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/conversions/events",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "conversions",
                "events"
              ]
            },
            "description": "Up to 1,000 events to the account's dataset (eg a Purchase after a click-to-WhatsApp ad). Defaults: action_source, messaging_channel, the WABA id.\n\nhttps://www.app2email.com/docs/api/analytics/send-conversion-events",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"data\": [\n    {\n      \"event_name\": \"Purchase\",\n      \"event_time\": 1793926800,\n      \"user_data\": {\n        \"ctwa_clid\": \"ARAkLkA8rmlFeiCktEJQ-QTwRiyYHAFDLMNDBH0CD3qpjd0HR4irJ6LEkR7JwFF4XvnO2E4Nx0-eM-GABDLOPaOdRMv-_zfUQ2a\"\n      },\n      \"custom_data\": {\n        \"currency\": \"EUR\",\n        \"value\": 49.9\n      }\n    }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "Calling",
      "description": "WhatsApp voice calls through your own WebRTC or SIP stack: settings, call actions, call permissions.",
      "item": [
        {
          "name": "WhatsApp calling settings",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/calling/settings?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "calling",
                "settings"
              ],
              "query": [
                {
                  "key": "include_sip_credentials",
                  "value": "",
                  "description": "true: the SIP password too (never for a sandbox key).",
                  "disabled": true
                }
              ]
            },
            "description": "Meta's settings of the number: calling on or off, call icon, call hours, call-back permission, SIP.\n\nhttps://www.app2email.com/docs/api/calling/get-call-settings"
          },
          "response": []
        },
        {
          "name": "Change the calling settings",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/calling/settings",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "calling",
                "settings"
              ]
            },
            "description": "Passed to Meta as {\"calling\": {...}}; status in upper case.\n\nhttps://www.app2email.com/docs/api/calling/update-call-settings",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"calling\": {\n    \"status\": \"ENABLED\",\n    \"call_icon_visibility\": \"DEFAULT\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Start, answer, reject or end a WhatsApp call",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/calls",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "calls"
              ]
            },
            "description": "Meta's call actions with your SDP. Answer an incoming call within 30 to 60 s. Business-initiated calls need the contact's permission and are billed per minute.\n\nhttps://www.app2email.com/docs/api/calling/manage-call",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"action\": \"accept\",\n  \"call_id\": \"wacid.HBgLMTY1MDU1NTEyMzQVAgARGCBBQkNERUY\",\n  \"session\": {\n    \"sdp_type\": \"answer\",\n    \"sdp\": \"v=0\\r\\no=- 4611731400430051336 2 IN IP4 127.0.0.1\\r\\ns=-\\r\\nt=0 0\\r\\n...\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "May the number call this contact",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/calls/permissions/:contact",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "calls",
                "permissions",
                ":contact"
              ],
              "variable": [
                {
                  "key": "contact",
                  "value": "61412345678",
                  "description": "The contact's number with country code, digits only, or their business-scoped user id."
                }
              ]
            },
            "description": "The contact's call permission and how many calls or permission requests are left.\n\nhttps://www.app2email.com/docs/api/calling/get-call-permission"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Account",
      "description": "The key, plan, usage, statistics and the request log.",
      "item": [
        {
          "name": "Check the key: its scopes, the number, the plan and the limits",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/me",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "me"
              ]
            },
            "description": "Works with any valid key, whatever its scopes. Use it for a 'test connection' step in Zapier, Make, n8n or Power Automate.\n\nhttps://www.app2email.com/docs/api/account/get-me"
          },
          "response": []
        },
        {
          "name": "The latest logged API requests",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/requests?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "requests"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "error",
                  "description": "error (400 and up), ok (below 400), or an HTTP status such as 422.",
                  "disabled": true
                }
              ]
            },
            "description": "Only errors (status 400 and up) and requests that change something (sends, webhook and settings changes) are logged, for 30 days. Each one has its request_id, route, status, time, key and address. No bodies and no keys are stored.\n\nhttps://www.app2email.com/docs/api/account/list-requests"
          },
          "response": []
        },
        {
          "name": "One logged request, by its request_id",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/requests/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "requests",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "kxrkf",
                  "description": "The request_id from an answer."
                }
              ]
            },
            "description": "The request_id of any answer, for example from a failed send.\n\nhttps://www.app2email.com/docs/api/account/get-request"
          },
          "response": []
        },
        {
          "name": "Messages and broadcasts per month",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/usage/history?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "usage",
                "history"
              ],
              "query": [
                {
                  "key": "months",
                  "value": "6",
                  "description": "How many months (1 to 24, default 6).",
                  "disabled": true
                }
              ]
            },
            "description": "Per calendar month (UTC), newest first: messages sent, failed, received and broadcasts.\n\nhttps://www.app2email.com/docs/api/account/get-usage-history"
          },
          "response": []
        },
        {
          "name": "Message counts, delivery and read rates for a period",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/stats?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "stats"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "2026-09-26T00:00:00Z",
                  "description": "Start of the range. ISO 8601.",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "2026-10-26T00:00:00Z",
                  "description": "End of the range. ISO 8601.",
                  "disabled": true
                }
              ]
            },
            "description": "For a time range (default the last 30 days, at most 366 days). The same counts as a broadcast report.\n\nhttps://www.app2email.com/docs/api/account/get-stats"
          },
          "response": []
        },
        {
          "name": "Plan, messages used and left, limits, what WhatsApp charges",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/usage",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "usage"
              ]
            },
            "description": "WhatsApp messages used and left this billing month, the billing period, the most numbers per send request, your own monthly cap, and `meta_pricing`: the month's messages by Meta's pricing category with an indicative cost.\n\nhttps://www.app2email.com/docs/api/account/get-usage"
          },
          "response": []
        },
        {
          "name": "What WhatsApp charges this billing month, per day",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/usage/meta",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "usage",
                "meta"
              ]
            },
            "description": "The billing month's messages by Meta's pricing category (the 1,000 free service messages, billable service, utility, marketing, authentication) with an indicative cost estimate, in all and per day. From the pricing object of WhatsApp's status webhooks; Meta bills you directly, so treat the amount as a guide.\n\nhttps://www.app2email.com/docs/api/account/get-usage-meta"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Account management",
      "description": "All numbers of an account: agent sign-up, status, number keys, plans, payment links, usage, account keys. Account key (a2ea_...) or the management_key of create_account.",
      "item": [
        {
          "name": "Instant sandbox: try the API with no account",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/sandbox",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "sandbox"
              ]
            },
            "description": "No key, no body, no person. Answers an instant sandbox key (a2es_..., valid 7 days) for app2email's demo number +12025550100, where pretend customers answer and nothing reaches WhatsApp. Send the key as Authorization: Bearer on `base_url` (GET /me, GET /templates, POST /messages, GET /messages, GET /conversations, PUT /conversations/{contact}/owner, GET /events, and POST /sandbox/inbound to make a pretend customer write) or on the MCP server. Requests, answers, errors and events have the shapes of the real API, and templates are checked by the same code. Each key has its own state, kept in memory for 24 hours after the last call. Any other call there answers 403 not_in_instant_sandbox. Limit: 10 keys an hour per address.\n\nhttps://www.app2email.com/docs/api/account-management/create-sandbox"
          },
          "response": []
        },
        {
          "name": "Start an account for a person (agent sign-up)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/account/signup",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "signup"
              ]
            },
            "description": "No key. E-mails the person a link to confirm; nothing is created until they do. Then they connect their WhatsApp number and pay. Every call makes a new sign-up, key and e-mail: an open sign-up of the same address is replaced (its link and management_key stop working). An address that has an account is never linked: the person creates an account key on the dashboard instead. Limits: per address, per e-mail address and in all (429 too_many_signups).\n\nhttps://www.app2email.com/docs/api/account-management/create-account",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contact_email\": \"ann@acme-bakery.example\",\n  \"business_name\": \"Acme Bakery\",\n  \"plan\": \"standard_5000\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Account status and what is still needed",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account"
              ]
            },
            "description": "pending_email, pending_whatsapp, pending_payment or live, with the numbers and next steps. Works with the management_key before the person confirms.\n\nhttps://www.app2email.com/docs/api/account-management/get-account"
          },
          "response": []
        },
        {
          "name": "Plans that can be bought",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/plans",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "plans"
              ]
            },
            "description": "Prices in US$, messages per month, and whether the plan includes the API. No key.\n\nhttps://www.app2email.com/docs/api/account-management/list-account-plans"
          },
          "response": []
        },
        {
          "name": "Cost estimate for a number of messages a month",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/estimate?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "estimate"
              ],
              "query": [
                {
                  "key": "messages_per_month",
                  "value": "5000",
                  "description": "Messages a month the plan must cover. Left out: the sum of the categories below.",
                  "disabled": true
                },
                {
                  "key": "email_bridge",
                  "value": "false",
                  "description": "true: only plans with the WhatsApp to email bridge.",
                  "disabled": true
                },
                {
                  "key": "api",
                  "value": "true",
                  "description": "false: also plans without the API.",
                  "disabled": true
                },
                {
                  "key": "yearly",
                  "value": "false",
                  "description": "true: the yearly price.",
                  "disabled": true
                },
                {
                  "key": "marketing",
                  "value": "",
                  "description": "Marketing template messages a month.",
                  "disabled": true
                },
                {
                  "key": "rate_marketing",
                  "value": "0.025",
                  "description": "Meta's price per marketing message, US$.",
                  "disabled": true
                },
                {
                  "key": "utility",
                  "value": "",
                  "description": "Utility template messages a month.",
                  "disabled": true
                },
                {
                  "key": "rate_utility",
                  "value": "",
                  "description": "Meta's price per utility message, US$.",
                  "disabled": true
                },
                {
                  "key": "authentication",
                  "value": "",
                  "description": "Authentication template messages a month.",
                  "disabled": true
                },
                {
                  "key": "rate_authentication",
                  "value": "",
                  "description": "Meta's price per authentication message, US$.",
                  "disabled": true
                },
                {
                  "key": "service",
                  "value": "",
                  "description": "Free-form (service) messages a month that Meta charges for.",
                  "disabled": true
                },
                {
                  "key": "rate_service",
                  "value": "",
                  "description": "Meta's price per service message, US$.",
                  "disabled": true
                }
              ]
            },
            "description": "No key. The cheapest plan that covers `messages_per_month` (outgoing WhatsApp and outgoing emails together) and its exact price. Meta's own per-message fees are billed by Meta and are not guessed: give the messages of each category and Meta's rate for it (from Meta's price list, for the recipients' country) and they are added to `total_per_month`.\n\nhttps://www.app2email.com/docs/api/account-management/estimate-cost"
          },
          "response": []
        },
        {
          "name": "The account's WhatsApp numbers",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/numbers",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "numbers"
              ]
            },
            "description": "Every number the account owns, with its status and plan.\n\nhttps://www.app2email.com/docs/api/account-management/list-account-numbers"
          },
          "response": []
        },
        {
          "name": "One number of the account",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/numbers/{{number}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "numbers",
                "{{number}}"
              ]
            },
            "description": "Its status, plan and billing period.\n\nhttps://www.app2email.com/docs/api/account-management/get-account-number"
          },
          "response": []
        },
        {
          "name": "The keys of a number",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/numbers/{{number}}/keys",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "numbers",
                "{{number}}",
                "keys"
              ]
            },
            "description": "Name, permissions, sandbox, last use. Never the keys themselves.\n\nhttps://www.app2email.com/docs/api/account-management/list-number-keys"
          },
          "response": []
        },
        {
          "name": "Create a key for a number",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/account/numbers/{{number}}/keys",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "numbers",
                "{{number}}",
                "keys"
              ]
            },
            "description": "The same key the dashboard makes, for /v1/{number}/... and the messaging MCP. Shown once. Sandbox unless \"sandbox\": false. The number must be live; at most 10 keys per number.\n\nhttps://www.app2email.com/docs/api/account-management/create-number-key",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Support agent\",\n  \"scopes\": \"send\",\n  \"sandbox\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Revoke a key of a number",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/numbers/{{number}}/keys/:key_id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "numbers",
                "{{number}}",
                "keys",
                ":key_id"
              ],
              "variable": [
                {
                  "key": "key_id",
                  "value": "1234",
                  "description": "The key's id (from the list)."
                }
              ]
            },
            "description": "Calls with it fail within 10 seconds. Cannot be undone.\n\nhttps://www.app2email.com/docs/api/account-management/revoke-number-key"
          },
          "response": []
        },
        {
          "name": "Payment link for a plan of a number",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/account/numbers/{{number}}/checkout",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "numbers",
                "{{number}}",
                "checkout"
              ]
            },
            "description": "A Stripe Checkout link for the person. Nothing is charged until they pay; the plan starts when Stripe confirms it. 409 plan_already_active for the plan the number has.\n\nhttps://www.app2email.com/docs/api/account-management/create-number-checkout",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"plan\": \"standard_5000\",\n  \"yearly\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Messages used this billing month, per number",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/usage?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "usage"
              ],
              "query": [
                {
                  "key": "number",
                  "value": "4976659348270",
                  "description": "Only this number (digits).",
                  "disabled": true
                }
              ]
            },
            "description": "Sent (WhatsApp + e-mail) against each plan's limit, and the totals.\n\nhttps://www.app2email.com/docs/api/account-management/get-account-usage"
          },
          "response": []
        },
        {
          "name": "Account keys",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/keys",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "keys"
              ]
            },
            "description": "The account's keys (never the keys themselves), management keys of agent sign-ups included.\n\nhttps://www.app2email.com/docs/api/account-management/list-account-keys"
          },
          "response": []
        },
        {
          "name": "Create an account key",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/account/keys",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "keys"
              ]
            },
            "description": "Shown once. Never more permissions than the calling key has. At most 20 per account.\n\nhttps://www.app2email.com/docs/api/account-management/create-account-key",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"Billing agent\",\n  \"scopes\": \"read\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Revoke an account key",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/keys/:key_id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "keys",
                ":key_id"
              ],
              "variable": [
                {
                  "key": "key_id",
                  "value": "ak_Hc4dR8sLm2Qv9Xw1",
                  "description": "The account key's id (from GET /v1/account/keys)."
                }
              ]
            },
            "description": "Also the key of this request. Cannot be undone.\n\nhttps://www.app2email.com/docs/api/account-management/revoke-account-key"
          },
          "response": []
        },
        {
          "name": "Account webhooks",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/webhooks",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "webhooks"
              ]
            },
            "description": "The account's webhooks with their last delivery. Every event of the account's numbers that can use the API (a plan with the API, LIVE); for every number also number.created, number.ready, number.disconnected, number.reconnected, trial.*, plan.limit_reached, api_key.*.\n\nhttps://www.app2email.com/docs/api/account-management/list-account-webhooks"
          },
          "response": []
        },
        {
          "name": "Add an account webhook",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/account/webhooks",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "webhooks"
              ]
            },
            "description": "Every event goes to every webhook (filter by type). Signed like a number's webhooks (X-App2email-Signature, X-Hub-Signature-256). At most 5. \"format\": \"meta\" is not available here.\n\nhttps://www.app2email.com/docs/api/account-management/create-account-webhook",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://hooks.example.com/app2email/account\",\n  \"headers\": {\n    \"Authorization\": \"Basic dXNlcjpwYXNz\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Change an account webhook",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/account/webhooks/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "webhooks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "url, active (true turns a switched-off webhook on), headers.\n\nhttps://www.app2email.com/docs/api/account-management/update-account-webhook",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"active\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete an account webhook",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/webhooks/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "webhooks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "No more events go to it.\n\nhttps://www.app2email.com/docs/api/account-management/delete-account-webhook"
          },
          "response": []
        },
        {
          "name": "Send a test event to an account webhook",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/account/webhooks/:id/test",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "webhooks",
                ":id",
                "test"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "No body: a ping. {\"type\": \"subscription.renewed\"}: that event's sample. {\"event\": {...}}: that event as given. 30 an hour.\n\nhttps://www.app2email.com/docs/api/account-management/test-account-webhook",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"message.status\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "New signing secret for an account webhook",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/account/webhooks/:id/rotate-secret",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "webhooks",
                ":id",
                "rotate-secret"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "keep_old_for_hours 1-24: the old secret signs too until then.\n\nhttps://www.app2email.com/docs/api/account-management/rotate-account-webhook-secret",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"keep_old_for_hours\": 24\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Deliveries of an account webhook",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/webhooks/:id/deliveries?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "webhooks",
                ":id",
                "deliveries"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "1 to 100.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "failed",
                  "description": "failed or delivered.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "The last 100 of 7 days, every attempt.\n\nhttps://www.app2email.com/docs/api/account-management/list-account-webhook-deliveries"
          },
          "response": []
        },
        {
          "name": "One delivery of an account webhook",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/webhooks/:id/deliveries/:event_id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "webhooks",
                ":id",
                "deliveries",
                ":event_id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                },
                {
                  "key": "event_id",
                  "value": "evt_Pa3k9m2Lw8Rt5Yp1Zs01",
                  "description": "The event's id (from the deliveries)."
                }
              ]
            },
            "description": "Every attempt and the event as sent.\n\nhttps://www.app2email.com/docs/api/account-management/get-account-webhook-delivery"
          },
          "response": []
        },
        {
          "name": "Send a stored event again to an account webhook",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/account/webhooks/:id/deliveries/:event_id/redeliver",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "account",
                "webhooks",
                ":id",
                "deliveries",
                ":event_id",
                "redeliver"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                },
                {
                  "key": "event_id",
                  "value": "evt_Pa3k9m2Lw8Rt5Yp1Zs01",
                  "description": "The event's id (from the deliveries)."
                }
              ]
            },
            "description": "Same event id and body.\n\nhttps://www.app2email.com/docs/api/account-management/redeliver-account-webhook-event"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Partner",
      "description": "Resellers: the partner account, clients, their numbers and number keys, onboarding links, usage, payments, partner webhooks. Partner key (a2ep_...) from /reseller/api-keys.",
      "item": [
        {
          "name": "The partner account",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner"
              ]
            },
            "description": "Status, site, Stripe connection, trial for new numbers, default redirect.\n\nhttps://www.app2email.com/docs/api/partner/get-partner"
          },
          "response": []
        },
        {
          "name": "Change the partner settings",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/partner",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner"
              ]
            },
            "description": "The trial for new client numbers and the default onboarding redirect. Branding, domain, pricing and Stripe stay on /reseller.\n\nhttps://www.app2email.com/docs/api/partner/update-partner",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"redirect_url\": \"https://crm.example.com/whatsapp/connected\",\n  \"trial\": {\n    \"enabled\": true,\n    \"messages\": 100,\n    \"days\": 14\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Clients",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/clients?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "clients"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "active",
                  "description": "active or suspended.",
                  "disabled": true
                },
                {
                  "key": "q",
                  "value": "",
                  "description": "Part of the e-mail address or name.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "1 to 200.",
                  "disabled": true
                },
                {
                  "key": "offset",
                  "value": "0",
                  "description": "Skip this many.",
                  "disabled": true
                }
              ]
            },
            "description": "Your clients with their numbers. Filter by status or q (e-mail, name).\n\nhttps://www.app2email.com/docs/api/partner/list-partner-clients"
          },
          "response": []
        },
        {
          "name": "Create a client",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/partner/clients",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "clients"
              ]
            },
            "description": "A login on your site, no password yet. send_invite (default): your invitation e-mail with a single-use 24 h link to choose a password and connect WhatsApp. One per e-mail address every 5 s; 100 a day.\n\nhttps://www.app2email.com/docs/api/partner/create-partner-client",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"email\": \"ann@example.com\",\n  \"name\": \"Ann's Bakery\",\n  \"send_invite\": true,\n  \"state\": \"crm-lead-4711\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "One client",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/clients/:client_id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "clients",
                ":client_id"
              ],
              "variable": [
                {
                  "key": "client_id",
                  "value": "k3x9q2m7v8w1r4t",
                  "description": "The client's id (from GET /v1/partner/clients)."
                }
              ]
            },
            "description": "The client and its numbers.\n\nhttps://www.app2email.com/docs/api/partner/get-partner-client"
          },
          "response": []
        },
        {
          "name": "Change a client",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/partner/clients/:client_id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "clients",
                ":client_id"
              ],
              "variable": [
                {
                  "key": "client_id",
                  "value": "k3x9q2m7v8w1r4t",
                  "description": "The client's id (from GET /v1/partner/clients)."
                }
              ]
            },
            "description": "name (logins of your site only), status: suspended logs the client out of your site.\n\nhttps://www.app2email.com/docs/api/partner/update-partner-client",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"status\": \"suspended\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Usage of a client",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/clients/:client_id/usage",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "clients",
                ":client_id",
                "usage"
              ],
              "variable": [
                {
                  "key": "client_id",
                  "value": "k3x9q2m7v8w1r4t",
                  "description": "The client's id (from GET /v1/partner/clients)."
                }
              ]
            },
            "description": "This billing month, per number of the client, and the totals.\n\nhttps://www.app2email.com/docs/api/partner/get-partner-client-usage"
          },
          "response": []
        },
        {
          "name": "Numbers of your clients",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/numbers?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "numbers"
              ],
              "query": [
                {
                  "key": "client_id",
                  "value": "k3x9q2m7v8w1r4t",
                  "description": "Only this client's numbers.",
                  "disabled": true
                }
              ]
            },
            "description": "Status, plan and features, messages used, current subscription. client_id: one client's.\n\nhttps://www.app2email.com/docs/api/partner/list-partner-numbers"
          },
          "response": []
        },
        {
          "name": "One number",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/numbers/{{number}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "numbers",
                "{{number}}"
              ]
            },
            "description": "Status, plan and features, messages used, current subscription.\n\nhttps://www.app2email.com/docs/api/partner/get-partner-number"
          },
          "response": []
        },
        {
          "name": "Usage of a number",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/numbers/{{number}}/usage",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "numbers",
                "{{number}}",
                "usage"
              ]
            },
            "description": "Sent (WhatsApp + e-mail) against the plan's limit, and received, this billing month.\n\nhttps://www.app2email.com/docs/api/partner/get-partner-number-usage"
          },
          "response": []
        },
        {
          "name": "Keys of a number",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/numbers/{{number}}/keys",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "numbers",
                "{{number}}",
                "keys"
              ]
            },
            "description": "Name, permissions, sandbox, last use. Never the keys themselves.\n\nhttps://www.app2email.com/docs/api/partner/list-partner-number-keys"
          },
          "response": []
        },
        {
          "name": "Create a key for a client's number",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/partner/numbers/{{number}}/keys",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "numbers",
                "{{number}}",
                "keys"
              ]
            },
            "description": "The dashboard's key, for /v1/{number}/... and the messaging MCP. Shown once. Sandbox unless \"sandbox\": false. The number must be LIVE on a plan with the API (409 number_not_live + Retry-After); at most 10 keys per number.\n\nhttps://www.app2email.com/docs/api/partner/create-partner-number-key",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"CRM\",\n  \"scopes\": \"send\",\n  \"sandbox\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Revoke a key of a client's number",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/numbers/{{number}}/keys/:key_id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "numbers",
                "{{number}}",
                "keys",
                ":key_id"
              ],
              "variable": [
                {
                  "key": "key_id",
                  "value": "812",
                  "description": "The key's id (from the list)."
                }
              ]
            },
            "description": "Calls with it fail within 10 seconds. Also while suspended.\n\nhttps://www.app2email.com/docs/api/partner/revoke-partner-number-key"
          },
          "response": []
        },
        {
          "name": "Onboarding link for a new or existing client",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/partner/onboarding-links",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "onboarding-links"
              ]
            },
            "description": "Single use, 24 h, signed, on your site. The person signs up or in, connects WhatsApp, presses Finish, and lands on redirect_url with ?client=<client id>&numbers=<number,...>&state=<state>.\n\nhttps://www.app2email.com/docs/api/partner/create-onboarding-link",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"email\": \"ben@example.com\",\n  \"name\": \"Ben's Garage\",\n  \"state\": \"crm-lead-4712\",\n  \"redirect_url\": \"https://crm.example.com/whatsapp/connected\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Client payments",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/payments?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "payments"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "2026-11-01",
                  "description": "From this date (ISO 8601).",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "2026-12-01",
                  "description": "Before this date.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "100",
                  "description": "1 to 500.",
                  "disabled": true
                }
              ]
            },
            "description": "Your Stripe ledger with app2email's fee, newest first, with totals per currency. This site's Stripe mode only.\n\nhttps://www.app2email.com/docs/api/partner/list-partner-payments"
          },
          "response": []
        },
        {
          "name": "Client plans",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/subscriptions?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "subscriptions"
              ],
              "query": [
                {
                  "key": "current",
                  "value": "",
                  "description": "true or false.",
                  "disabled": true
                },
                {
                  "key": "client_id",
                  "value": "",
                  "description": "Only this client's.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "100",
                  "description": "1 to 500.",
                  "disabled": true
                }
              ]
            },
            "description": "Every plan of your clients' numbers, newest first. current=true: the plans in force.\n\nhttps://www.app2email.com/docs/api/partner/list-partner-subscriptions"
          },
          "response": []
        },
        {
          "name": "Partner webhooks",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/webhooks",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "webhooks"
              ]
            },
            "description": "Your webhooks with their last delivery. Every event of every client number, plus the partner events (client.*, subscription.*, trial.*, ...).\n\nhttps://www.app2email.com/docs/api/partner/list-partner-webhooks"
          },
          "response": []
        },
        {
          "name": "Add a partner webhook",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/partner/webhooks",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "webhooks"
              ]
            },
            "description": "Every event goes to every webhook (filter by type). Signed like a number's webhooks (X-App2email-Signature, X-Hub-Signature-256). At most 5. \"format\": \"meta\" is not available here.\n\nhttps://www.app2email.com/docs/api/partner/create-partner-webhook",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"https://crm.example.com/app2email/partner-events\",\n  \"headers\": {\n    \"Authorization\": \"Basic dXNlcjpwYXNz\"\n  }\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Change a partner webhook",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/partner/webhooks/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "webhooks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "url, active (true turns a switched-off webhook on), headers.\n\nhttps://www.app2email.com/docs/api/partner/update-partner-webhook",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"active\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete a partner webhook",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/webhooks/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "webhooks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "No more events go to it. Also while suspended.\n\nhttps://www.app2email.com/docs/api/partner/delete-partner-webhook"
          },
          "response": []
        },
        {
          "name": "Send a test event to a partner webhook",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/partner/webhooks/:id/test",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "webhooks",
                ":id",
                "test"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "No body: a ping. {\"type\": \"subscription.renewed\"}: that event's sample. {\"event\": {...}}: that event as given. 30 an hour.\n\nhttps://www.app2email.com/docs/api/partner/test-partner-webhook",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"type\": \"client.created\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "New signing secret for a partner webhook",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/partner/webhooks/:id/rotate-secret",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "webhooks",
                ":id",
                "rotate-secret"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "keep_old_for_hours 1-24: the old secret signs too until then.\n\nhttps://www.app2email.com/docs/api/partner/rotate-partner-webhook-secret",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"keep_old_for_hours\": 24\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Deliveries of a partner webhook",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/webhooks/:id/deliveries?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "webhooks",
                ":id",
                "deliveries"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "50",
                  "description": "1 to 100.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "failed",
                  "description": "failed or delivered.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                }
              ]
            },
            "description": "The last 100 of 7 days, every attempt.\n\nhttps://www.app2email.com/docs/api/partner/list-partner-webhook-deliveries"
          },
          "response": []
        },
        {
          "name": "One delivery of a partner webhook",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/webhooks/:id/deliveries/:event_id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "webhooks",
                ":id",
                "deliveries",
                ":event_id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                },
                {
                  "key": "event_id",
                  "value": "evt_Pa3k9m2Lw8Rt5Yp1Zs01",
                  "description": "The event's id (from the deliveries)."
                }
              ]
            },
            "description": "Every attempt and the event as sent.\n\nhttps://www.app2email.com/docs/api/partner/get-partner-webhook-delivery"
          },
          "response": []
        },
        {
          "name": "Send a stored event again to a partner webhook",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/partner/webhooks/:id/deliveries/:event_id/redeliver",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "partner",
                "webhooks",
                ":id",
                "deliveries",
                ":event_id",
                "redeliver"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "wh_a1b2c3d4e5f6g7h8",
                  "description": "The webhook's id."
                },
                {
                  "key": "event_id",
                  "value": "evt_Pa3k9m2Lw8Rt5Yp1Zs01",
                  "description": "The event's id (from the deliveries)."
                }
              ]
            },
            "description": "Same event id and body.\n\nhttps://www.app2email.com/docs/api/partner/redeliver-partner-webhook-event"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Calendar",
      "description": "The business calendar: appointments, blocked time, internal notes, links to the online booking page and held times. Services, staff and the next free times for agents.",
      "item": [
        {
          "name": "Change an appointment's details",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "BK-7Q3M2A",
                  "description": "The booking's id, or its reference (BK-XXXXXX)."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. The customer's `name` or `email`, the `notes`, the `answers` and the staff member (`provider_id`: the time must be free for the new one, else 409 `booking_slot_taken`; the calendar event moves too). The time is changed with POST /bookings/{id}/reschedule. `booking.updated` is sent with `changed` naming the fields.\n\nhttps://www.app2email.com/docs/api/calendar/update-booking",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"notes\": \"Allergic to ammonia\",\n  \"provider_id\": \"tom\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Everything on the calendar for a range of days",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/calendar?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "calendar"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "2026-11-10",
                  "description": "The first day, YYYY-MM-DD in the business time zone. Default today.",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "2026-11-16",
                  "description": "The last day (included). Default from + 6 days; at most 62 days.",
                  "disabled": true
                },
                {
                  "key": "provider_id",
                  "value": "maria",
                  "description": "Only this staff member's entries (and the business-wide ones). Left out: everyone.",
                  "disabled": true
                },
                {
                  "key": "include",
                  "value": "bookings,blocks",
                  "description": "Comma list of bookings, blocks, busy, holds. Default: all four.",
                  "disabled": true
                },
                {
                  "key": "cancelled",
                  "value": "false",
                  "description": "true: also the cancelled appointments.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). One feed for a range of days (business time zone; default 7 days from today, at most 62): the appointments, the blocked time, the busy time of the connected calendar (our own appointments left out) and the times held right now, each with `start`/`end` in UTC and `start_local`/`end_local`; plus the opening hours per day (overrides applied), the staff and the services. `include` picks any of `bookings,blocks,busy,holds`; cancelled appointments only with `cancelled=true`.\n\nhttps://www.app2email.com/docs/api/calendar/get-calendar"
          },
          "response": []
        },
        {
          "name": "The blocked times",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/calendar/blocks?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "calendar",
                "blocks"
              ],
              "query": [
                {
                  "key": "from",
                  "value": "2026-11-10",
                  "description": "The first day, YYYY-MM-DD. Default today.",
                  "disabled": true
                },
                {
                  "key": "to",
                  "value": "2026-12-10",
                  "description": "The last day (included). Default from + 30 days.",
                  "disabled": true
                },
                {
                  "key": "provider_id",
                  "value": "maria",
                  "description": "One staff member's blocks and the business-wide ones.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). The time blocks touching a range of days (business time zone; default 31 days from today, at most 62), soonest first. With `provider_id`: that staff member's blocks and the business-wide ones.\n\nhttps://www.app2email.com/docs/api/calendar/list-calendar-blocks"
          },
          "response": []
        },
        {
          "name": "Block time so that no one can book it",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/calendar/blocks",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "calendar",
                "blocks"
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. Time off, a break, a closed afternoon: for one staff member (`provider_id`) or the whole business. Give `start` and `end`, or `date` for one whole day. Existing appointments are not touched. The block is made with `source` \"api\" and `created_by` \"API key <name>\"; `calendar.block.created` is sent. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/calendar/create-calendar-block",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"start\": \"2026-11-14T12:00\",\n  \"end\": \"2026-11-14T13:00\",\n  \"provider_id\": \"maria\",\n  \"title\": \"Lunch\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Change a blocked time",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/calendar/blocks/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "calendar",
                "blocks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "3",
                  "description": "The block's id."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. Any of `start`, `end`, `date`, `provider_id`, `title`, `notes`; what is left out stays.\n\nhttps://www.app2email.com/docs/api/calendar/update-calendar-block",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"end\": \"2026-11-14T13:30\",\n  \"title\": \"Long lunch\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Remove a blocked time",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/calendar/blocks/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "calendar",
                "blocks",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "3",
                  "description": "The block's id."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. The time can be booked again. `calendar.block.deleted` is sent.\n\nhttps://www.app2email.com/docs/api/calendar/delete-calendar-block"
          },
          "response": []
        },
        {
          "name": "The services a customer can book, and their staff",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/services",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "services"
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). The enabled services with their length, price and description, and the staff members who do each one (`staff` is empty when the business has no staff). The ids go into GET /bookings/availability, GET /bookings/next, POST /bookings and POST /bookings/holds.\n\nhttps://www.app2email.com/docs/api/calendar/list-bookable-services"
          },
          "response": []
        },
        {
          "name": "The staff members and the services they do",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/staff",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "staff"
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). The enabled staff members (`provider_id` in the other calls) with the ids of the enabled services each one does. Empty when the business has no staff.\n\nhttps://www.app2email.com/docs/api/calendar/list-booking-staff"
          },
          "response": []
        },
        {
          "name": "The next free start times for a service, across days",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/next?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "next"
              ],
              "query": [
                {
                  "key": "service_id",
                  "value": "haircut",
                  "description": "The service (GET /bookings/services).",
                  "disabled": true
                },
                {
                  "key": "provider_id",
                  "value": "maria",
                  "description": "One staff member's own availability. Left out: anyone available.",
                  "disabled": true
                },
                {
                  "key": "after",
                  "value": "2026-11-12",
                  "description": "Only times after this: a day (YYYY-MM-DD, its start in the business time zone) or an ISO 8601 time. Default now.",
                  "disabled": true
                },
                {
                  "key": "count",
                  "value": "5",
                  "description": "How many slots (1 to 20).",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). Like GET /bookings/availability but without choosing days: the next `count` free start times after `after` (default now), looking at most 60 days ahead. Each slot's `id` is what POST /bookings, /bookings/holds and /bookings/{id}/reschedule take as `start`.\n\nhttps://www.app2email.com/docs/api/calendar/get-next-booking-slots"
          },
          "response": []
        },
        {
          "name": "Move an appointment to another time",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/:id/reschedule",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                ":id",
                "reschedule"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "BK-7Q3M2A",
                  "description": "The booking's id, or its reference (BK-XXXXXX)."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. Moves a confirmed appointment in place: same `id` and `reference`, the calendar event moved, reminders start again. `start` must be a free slot (the booking's own time counts as free). The customer is told on WhatsApp unless `notify` is false. `booking.rescheduled` is sent with `rescheduled_from`. 409 `booking_slot_taken` when the time is not free. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/calendar/reschedule-booking",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"start\": \"2026-11-12T10:00\",\n  \"notify\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The internal notes of an appointment and its customer",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/:id/notes",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                ":id",
                "notes"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "BK-7Q3M2A",
                  "description": "The booking's id, or its reference (BK-XXXXXX)."
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). The notes written on this appointment and the customer's other notes, pinned first then newest; `on_this_booking` tells them apart. Notes are never shown to the customer.\n\nhttps://www.app2email.com/docs/api/calendar/list-booking-notes"
          },
          "response": []
        },
        {
          "name": "Add an internal note to an appointment",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/:id/notes",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                ":id",
                "notes"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "BK-7Q3M2A",
                  "description": "The booking's id, or its reference (BK-XXXXXX)."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. The note is about the appointment's customer and written on this appointment. `author` is \"API key <name>\" and `author_kind` \"api\". `booking.note.created` is sent. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/calendar/add-booking-note",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"body\": \"Prefers the window seat.\",\n  \"pinned\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The internal notes of a customer",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/notes?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "notes"
              ],
              "query": [
                {
                  "key": "contact",
                  "value": "61412345678",
                  "description": "The customer: number with country code, or business-scoped user id. Required.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). Every note about one customer (`contact` is required), pinned first then newest. Page with `next_cursor`.\n\nhttps://www.app2email.com/docs/api/calendar/list-customer-notes"
          },
          "response": []
        },
        {
          "name": "Add an internal note to a customer",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/notes",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "notes"
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. Give `contact`, or `booking_id` to write it on one appointment (the customer is taken from it). `author` is \"API key <name>\", `author_kind` \"api\". `booking.note.created` is sent. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/calendar/add-customer-note",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contact\": \"61412345678\",\n  \"body\": \"Prefers the window seat.\",\n  \"pinned\": false\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Delete an internal note",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/notes/:note_id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "notes",
                ":note_id"
              ],
              "variable": [
                {
                  "key": "note_id",
                  "value": "7",
                  "description": "The note's id."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. The note is hidden from every list.\n\nhttps://www.app2email.com/docs/api/calendar/delete-booking-note"
          },
          "response": []
        },
        {
          "name": "The personal booking links",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/links?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "links"
              ],
              "query": [
                {
                  "key": "contact",
                  "value": "61412345678",
                  "description": "Only this customer's links.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). The personal links of the number, newest first; `contact` shows one customer's. Each has its `state` (ok, expired, revoked, used_up, off) and how often it was opened. Page with `next_cursor`.\n\nhttps://www.app2email.com/docs/api/calendar/list-booking-links"
          },
          "response": []
        },
        {
          "name": "Make a link that opens the online booking page",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/links",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "links"
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. A link for a customer to book, move an appointment (`purpose` reschedule + `booking_id`) or manage their appointments (`purpose` manage). Send the `url` to the customer yourself. With a `contact` the page knows the customer and confirms the booking right away; without one it is a one-off link and the customer confirms on WhatsApp. The online booking page must be switched on, else the answer says the link will not open yet. `created_by` is \"API key <name>\", `source` \"api\". Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/calendar/create-booking-link",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contact\": \"61412345678\",\n  \"name\": \"John\",\n  \"purpose\": \"book\",\n  \"expires_in_hours\": 48\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Revoke a personal booking link",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/links/:code",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "links",
                ":code"
              ],
              "variable": [
                {
                  "key": "code",
                  "value": "k3XbQ9rTzP2m",
                  "description": "The link's code (or its id)."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. The link stops opening. The public address is not a personal link: change it on the dashboard.\n\nhttps://www.app2email.com/docs/api/calendar/revoke-booking-link"
          },
          "response": []
        },
        {
          "name": "Keep a free time for a few minutes",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/holds",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "holds"
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. Keeps a free time for `minutes` (1 to 30, default 10) so no one else can book it while the customer decides: it counts as taken in the availability, the calendar and every booking check. The slot is checked like a booking is; 409 `booking_slot_taken` when it is not free. Book it with POST /bookings and `hold` (the `reference`), or release it with DELETE; it frees itself at `expires`. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/calendar/create-booking-hold",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"service_id\": \"haircut\",\n  \"start\": \"2026-11-10T09:00\",\n  \"provider_id\": \"maria\",\n  \"contact\": \"61412345678\",\n  \"name\": \"John\",\n  \"minutes\": 10\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Release a held time",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/holds/:reference",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "holds",
                ":reference"
              ],
              "variable": [
                {
                  "key": "reference",
                  "value": "BK-4HT9XC",
                  "description": "The hold's reference, as POST /bookings/holds answered."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. Frees the time at once. Releasing a time that was already released answers 200 again; one that expired or was booked answers 409 `hold_expired`.\n\nhttps://www.app2email.com/docs/api/calendar/release-booking-hold"
          },
          "response": []
        }
      ]
    },
    {
      "name": "Payments",
      "description": "Payments for appointments through the business's own Stripe or PayPal account, one-off payment requests, refunds, prepaid packages, the customer profile (with GDPR-style erase) and meeting polls.",
      "item": [
        {
          "name": "The payments, newest first",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/payments?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "payments"
              ],
              "query": [
                {
                  "key": "booking",
                  "value": "BK-7Q3M2A",
                  "description": "Only this appointment's payments (id or BK- reference).",
                  "disabled": true
                },
                {
                  "key": "contact",
                  "value": "61412345678",
                  "description": "Only this customer's payments.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "pending",
                  "description": "Only this status.",
                  "disabled": true
                },
                {
                  "key": "kind",
                  "value": "booking",
                  "description": "Only this kind.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). The payments of appointments, package purchases and payment requests. Filter by `booking` (id or reference), `contact`, `status` and `kind`. Page with `next_cursor`.\n\nhttps://www.app2email.com/docs/api/payments/list-payments"
          },
          "response": []
        },
        {
          "name": "One payment",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/payments/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "payments",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "15",
                  "description": "The payment's id."
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). No provider key or secret is ever in the answer.\n\nhttps://www.app2email.com/docs/api/payments/get-payment"
          },
          "response": []
        },
        {
          "name": "Ask a customer to pay an amount",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/payments/links",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "payments",
                "links"
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. Makes a one-off payment request and the page where the customer pays (the business's own Stripe or PayPal). With `send` true and the customer inside their 24 hour window they also get it on WhatsApp with a Pay button; otherwise send the `url` yourself. 409 `payments_not_connected` when no provider is connected. `payment.paid` is sent when it is paid. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/payments/create-payment-link",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contact\": \"61412345678\",\n  \"amount\": 40,\n  \"description\": \"Deposit for your colour\",\n  \"booking_id\": \"BK-7Q3M2A\",\n  \"send\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Refund a payment, in full or a part",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/payments/:id/refund",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "payments",
                ":id",
                "refund"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "15",
                  "description": "The payment's id."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. Sends real money back through the business's own provider; it cannot be undone. `amount` is a part in the payment's currency; left out, everything that is left. A full refund of an appointment's payment sets its `payment.status` to refunded. `booking.refunded` is sent. 409 `refund_not_possible`, 502 `payment_provider_error`. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up). For a payment of kind `ticket` use `POST /tickets/orders/{id}/refund` instead: it also ends the tickets.\n\nhttps://www.app2email.com/docs/api/payments/refund-payment",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"amount\": 10\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Record a payment taken outside app2email",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/:id/payment",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                ":id",
                "payment"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "BK-7Q3M2A",
                  "description": "The booking's id, or its reference (BK-XXXXXX)."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. The business's own record: `paid` (cash, a terminal), `waived` (nothing to pay) or `due` (still expected). Nothing is charged or refunded; online payments are recorded by the provider. The booking's `payment` shows the result.\n\nhttps://www.app2email.com/docs/api/payments/set-booking-payment",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"status\": \"paid\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The prepaid packages on sale",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/packages",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "packages"
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). The enabled packages of the business (config.payments.packages) with their price and the services they cover. Customers buy them on the online booking page; POST /bookings/packages/grant gives one without a payment.\n\nhttps://www.app2email.com/docs/api/payments/list-packages"
          },
          "response": []
        },
        {
          "name": "The packages customers hold",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/packages/purchases?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "packages",
                "purchases"
              ],
              "query": [
                {
                  "key": "contact",
                  "value": "61412345678",
                  "description": "Only this customer's.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "live",
                  "description": "live, or one status.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). Purchases and grants, newest first. `status=live` = active with sessions left.\n\nhttps://www.app2email.com/docs/api/payments/list-package-purchases"
          },
          "response": []
        },
        {
          "name": "Give a customer a package without a payment",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/packages/grant",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "packages",
                "grant"
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. Makes an active purchase of a package on sale (`sessions` overrides its session count). `package.purchased` is sent with `granted: true`. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/payments/grant-package",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"contact\": \"61412345678\",\n  \"package_id\": \"ten-pack\",\n  \"name\": \"John\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "The customers with appointments",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/customers?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "customers"
              ],
              "query": [
                {
                  "key": "q",
                  "value": "smith",
                  "description": "Name, e-mail or number contains this.",
                  "disabled": true
                },
                {
                  "key": "tag",
                  "value": "vip",
                  "description": "Only contacts with this tag.",
                  "disabled": true
                },
                {
                  "key": "sort",
                  "value": "recent",
                  "description": "recent (default), name or visits.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 200, default 50).",
                  "disabled": true
                },
                {
                  "key": "cursor",
                  "value": "",
                  "description": "The next_cursor of the previous answer, unchanged. Leave out for the first page.",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). The people who have appointments, newest activity first, with visits, no-shows, upcoming count, packages left and the total paid. `q` searches name, e-mail and number; `tag` filters by a contact tag. Page with `next_cursor`.\n\nhttps://www.app2email.com/docs/api/payments/list-booking-customers"
          },
          "response": []
        },
        {
          "name": "A customer's whole profile",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/customers/:contact",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "customers",
                ":contact"
              ],
              "variable": [
                {
                  "key": "contact",
                  "value": "61412345678",
                  "description": "The customer: number with country code, or business-scoped user id."
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). Contact details and tags, upcoming and past appointments, internal notes and reminders, packages, payments, stats and the last 20 messages: one call for an agent that is about to talk to the customer.\n\nhttps://www.app2email.com/docs/api/payments/get-customer-profile"
          },
          "response": []
        },
        {
          "name": "Change a customer's name, e-mail, tags or fields",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/customers/:contact",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "customers",
                ":contact"
              ],
              "variable": [
                {
                  "key": "contact",
                  "value": "61412345678",
                  "description": "The customer: number with country code, or business-scoped user id."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. Updates the contact record (made when there is none). The e-mail also goes onto the customer's upcoming confirmed appointments so their e-mails reach the new address.\n\nhttps://www.app2email.com/docs/api/payments/update-customer",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"email\": \"john.new@example.com\",\n  \"tags\": [\n    \"vip\",\n    \"colour\"\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "Erase a customer's booking data",
          "request": {
            "method": "DELETE",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/customers/:contact",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "customers",
                ":contact"
              ],
              "variable": [
                {
                  "key": "contact",
                  "value": "61412345678",
                  "description": "The customer: number with country code, or business-scoped user id."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. For a privacy request. Future confirmed appointments are cancelled without a message (reason \"data erased\"); every appointment of the customer loses their number, name, e-mail, notes and answers (the row stays, anonymised, so reports still count it); their notes, links, holds and poll votes are deleted; package purchases and payments keep amounts and dates but lose the customer. The contact record and the conversation are kept: `DELETE /contacts/{identity}?booking_data=erase` removes the contact too. `booking.customer.erased` is sent. It cannot be undone.\n\nhttps://www.app2email.com/docs/api/payments/erase-customer-booking-data"
          },
          "response": []
        },
        {
          "name": "The meeting polls",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/polls?",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "polls"
              ],
              "query": [
                {
                  "key": "status",
                  "value": "open",
                  "description": "Only this status.",
                  "disabled": true
                },
                {
                  "key": "limit",
                  "value": "50",
                  "description": "How many (1 to 100, default 50).",
                  "disabled": true
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). Newest first, with options, votes and status.\n\nhttps://www.app2email.com/docs/api/payments/list-polls"
          },
          "response": []
        },
        {
          "name": "Offer several times and let people vote",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/polls",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "polls"
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. 2 to 10 possible start times (each free now; the business's rule: inside the opening hours), a title, a service or a length. The times are not held. Share the `url`: people open it and vote. Pick the winner with POST /bookings/polls/{id}/book. `poll.voted` is sent for each vote. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/payments/create-poll",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"title\": \"Team planning\",\n  \"service_id\": \"consultation\",\n  \"options\": [\n    \"2026-11-12T10:00\",\n    \"2026-11-12T14:00\",\n    \"2026-11-13T09:00\"\n  ],\n  \"closes_at\": \"2026-11-12T00:00:00Z\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "One poll with its votes",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/polls/:id",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "polls",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "12",
                  "description": "The poll's id."
                }
              ]
            },
            "description": "Scope: `bookings:manage` (or `messages:read`). The options with their vote counts and voters, and every vote with the voter's name, number and comment.\n\nhttps://www.app2email.com/docs/api/payments/get-poll"
          },
          "response": []
        },
        {
          "name": "Close a poll to new votes",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/polls/:id/close",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "polls",
                ":id",
                "close"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "12",
                  "description": "The poll's id."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. No more votes. `poll.closed` is sent with status `closed`.\n\nhttps://www.app2email.com/docs/api/payments/close-poll"
          },
          "response": []
        },
        {
          "name": "Pick the winning time",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "order-1234-shipped",
                "description": "Optional. A unique value for this message or list (eg a UUID). The same request with the same key within 24 hours gets the first answer again, and nothing is sent twice. Ignored by dry runs.",
                "disabled": true
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/v1/{{number}}/bookings/polls/:id/book",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "{{number}}",
                "bookings",
                "polls",
                ":id",
                "book"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "12",
                  "description": "The poll's id."
                }
              ]
            },
            "description": "Scope: `bookings:manage`. Not with a sandbox key. The option is checked like a business booking (409 `booking_slot_taken` when it is not free any more). With a main contact an appointment is made for them (source dashboard; the normal WhatsApp confirmation unless `notify` is false); without one the time is blocked in the calendar under the poll's title. The poll becomes `booked` and `poll.closed` is sent with the chosen option. Send an `Idempotency-Key` header to retry safely: the same key and body within 24 hours gets the first answer again (an error does not use the key up).\n\nhttps://www.app2email.com/docs/api/payments/book-poll",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"option_id\": \"a\",\n  \"notify\": true\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    }
  ]
}