# poll.closed

HTML: https://www.app2email.com/docs/api/webhooks/poll.closed · Index: https://www.app2email.com/docs/api/llms.txt

A meeting poll was closed, or its winning time was booked (status booked, with chosen_option).

Group: Book-and-Pay. Header `X-App2email-Event: poll.closed`. Inside the envelope `{id, type, created, number, test?, data}` ([envelope, headers, signature](https://www.app2email.com/docs/api/webhooks.md)). Every webhook of the number gets every number event: filter by `type`.

## data

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `data.poll_id` | integer | yes |  |
| `data.title` | string |  |  |
| `data.status` | string | yes | one of: `closed`, `booked` |
| `data.chosen_option` | string |  |  |
| `data.appointment_id` | integer |  |  |
| `data.by` | string |  |  |
| `data.timestamp` | string |  |  |

## Samples

### booked

```json
{
  "id": "evt_Pay3k9m2Lw8Rt5Yp1Zs06",
  "type": "poll.closed",
  "created": "2026-11-11T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "poll_id": 12,
    "title": "Team planning",
    "status": "booked",
    "chosen_option": "c",
    "appointment_id": null,
    "by": "jane@example.com",
    "timestamp": "2026-11-11T01:00:00.000Z"
  }
}
```

## Caused by

- [Close a poll to new votes](https://www.app2email.com/docs/api/payments/close-poll.md): `POST /v1/{number}/bookings/polls/{id}/close`
- [Pick the winning time](https://www.app2email.com/docs/api/payments/book-poll.md): `POST /v1/{number}/bookings/polls/{id}/book`

Send it to your URL: https://www.app2email.com/docs/api/webhooks/tester?type=poll.closed
