Docs
Webhooksv4

List webhook payload versions

GET/webhooks/versions

Every payload version a subscription can be set to, newest first, with what each one changed. New subscriptions default to the version marked latest. Set a subscription's version with api_version on create or update.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Returns

dataoptionalWebhookApiVersion[]

Array of WebhookApiVersion

versionRequiredstring

A webhook payload version, as a release date. 2026-10-01 is the latest.

"2026-10-01""2026-09-01"
latestRequiredboolean

True for exactly one version: the one new subscriptions get.

released_atRequiredstring
summaryRequiredstring
changesRequiredstring[]

What this version changed relative to the one before it. Empty for the baseline.

Response codes

200Supported payload versions, newest first
401Your API key is missing or invalid. Pass it as a bearer token.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request
curl -X GET https://api.blooio.com/v4/webhooks/versions \
Response objectexample
{  "data": [    {      "version": "2026-10-01",      "latest": true,      "released_at": "2026-10-01",      "summary": "Removes fields left over from v2 payloads and chat_guid, and reports message errors by their public code.",      "changes": [        "Removed event, timestamp, external_id, internal_id, participants and legacy_reaction_id from typing.*, message.reaction, contact.shared and poll.voted. Use the envelope's type, created_at and id, and data.contact, data.group and data.channel_address.",        "Removed the flat group_id and group_name wherever data carries a group object (group.* events keep group_id). Read group.group_id and group.name.",        "Removed chat_guid. Use chat_id and group.group_id to tell conversations apart.",        "error.code on message events is one of the public error codes (for example service_unavailable or delivery_unconfirmed), the same code the REST API returns. 2026-09-01 keeps the previous codes; error.message is the public description on both."      ]    },    {      "version": "2026-09-01",      "latest": false,      "released_at": "2026-09-01",      "summary": "Baseline: the payload every subscription received before versioning.",      "changes": []    }  ]}