Skip to main content
PATCH
Update or pause a webhook endpoint
Send only the fields you want to change. When supplied, event_types replaces the entire subscription list. Set status to PAUSED to stop creating deliveries for new events. Set it to ACTIVE to resume delivery and clear the consecutive-failure counter.
Events generated while an endpoint is paused are not backfilled when it is reactivated.

Authorizations

x-api-key
string
header
required

Environment-specific API key created in the Unifystays portal

Headers

Path Parameters

endpoint_id
string
required

Webhook endpoint UUID.

Example:

"8b95a9e0-4af3-4c6d-92df-84b64256d27f"

Body

application/json
name
string

New human-readable endpoint name.

Required string length: 1 - 120
Example:

"Production booking events"

url
string

New public HTTPS delivery URL.

Required string length: 8 - 2048
Example:

"https://example.com/webhooks/unifystays"

event_types
enum<string>[]

Replacement event subscriptions. Send the complete desired list.

Required array length: 1 - 20 elements
Available options:
booking.created,
booking.confirmed,
booking.failed,
booking.cancellation_requested,
booking.cancelled,
booking.cancellation_failed,
booking.*
Example:
status
enum<string>

Activate or pause delivery to this endpoint.

Available options:
ACTIVE,
PAUSED
Example:

"ACTIVE"

Response

200 - application/json

Webhook endpoint updated successfully.

id
string<uuid>
required

Unique webhook endpoint identifier.

Example:

"8b95a9e0-4af3-4c6d-92df-84b64256d27f"

name
string
required

Human-readable endpoint name.

Example:

"Production booking events"

url
string<uri>
required

URL that receives signed webhook POST requests.

Example:

"https://example.com/webhooks/unifystays"

status
enum<string>
required

Current endpoint state. Paused and disabled endpoints do not receive new deliveries.

Available options:
ACTIVE,
PAUSED,
DISABLED
Example:

"ACTIVE"

event_types
enum<string>[]
required

Normalized event subscriptions for this endpoint.

Available options:
booking.created,
booking.confirmed,
booking.failed,
booking.cancellation_requested,
booking.cancelled,
booking.cancellation_failed,
booking.*
Example:
consecutive_failures
number
required

Consecutive delivery failures since the last success or reactivation.

Example:

0

last_success_at
string<date-time> | null
required

Time of the most recent successful delivery, if any.

Example:

"2026-08-08T08:30:00.000Z"

last_failure_at
string<date-time> | null
required

Time of the most recent failed delivery, if any.

Example:

null

disabled_at
string<date-time> | null
required

Time the endpoint was disabled, if applicable.

Example:

null

disabled_reason
string | null
required

Reason the endpoint was disabled, if applicable.

Example:

null

created_at
string<date-time>
required

Endpoint creation time.

Example:

"2026-08-08T08:00:00.000Z"

updated_at
string<date-time>
required

Time the endpoint was last updated.

Example:

"2026-08-08T08:30:00.000Z"