Skip to main content
Preview. Gridbeds sends no notification yet: this webhook is part of the released contract (version 1.0.0). See Webhooks for how to verify and apply one.

Headers

webhook-id
string
required

Opaque. Ordered within your channel; do not parse.

Pattern: ^evt_(test_)?[0-9a-hjkmnp-tv-z]{13}$
Example:

"evt_00000000000ab"

webhook-timestamp
string
required

Unix seconds. Reject if more than 5 minutes off.

Pattern: ^[0-9]+$
webhook-signature
string
required

Space-separated v1,<base64 HMAC-SHA256(secret, id.timestamp.body)>.

Body

application/json
id
string
required

Opaque. Ordered within your channel; do not parse.

Pattern: ^evt_(test_)?[0-9a-hjkmnp-tv-z]{13}$
Example:

"evt_00000000000ab"

type
enum<string>
required

Open enum.

Available options:
location.created,
location.updated,
location.deleted,
owner.created,
owner.updated,
owner.deleted,
property.created,
property.updated,
property.deleted,
property.distributed,
property.withdrawn,
availability.updated
occurred_at
string<date-time>
required
Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$
Example:

"2026-10-16T09:30:00Z"

channel
string
required
data
object
required

Response

Acknowledged.