Skip to main content
PATCH
Update Superagent webhook

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>.

Path Parameters

webhook_id
string
required

ID of the webhook to change. Get it from List Superagent webhooks.

agent_id
string
required

ID of the Superagent. It's the agent's app ID, shown in the agent's developer settings.

Body

application/json
target_url
string | null

New public HTTPS URL that receives the events.

Example:

"https://example.com/hooks/agent-v2"

events
string[] | null

New set of events to receive. One or more of message.created and message.completed.

Example:
description
string | null

New label for the webhook, or null to remove it.

Example:

"CRM sync"

enabled
boolean | null

true turns the webhook back on and resets consecutive_failures. false turns it off.

Example:

true

signing
string | null

rotate generates a new signing secret and returns it once in secret. disable removes the secret, so deliveries are no longer signed.

Example:

"rotate"

Response

The updated webhook.

A webhook subscription, with its signing secret when one was just generated.

id
string
required

ID of the webhook.

Example:

"68a1d0f4f0b9d3002e7a5c52"

target_url
string
required

HTTPS URL Base44 sends the events to.

Example:

"https://example.com/hooks/agent"

events
enum<string>[]
required

Events the webhook receives. message.created fires when a message is added to a conversation, and message.completed when the agent finishes a reply.

Available options:
message.created,
message.completed
Example:
description
string | null
required

Your label for the webhook, or null when it has none.

Example:

"CRM sync"

has_secret
boolean
required

Whether deliveries are signed. When true, each delivery carries an X-Base44-Signature header, an HMAC-SHA256 of the body.

Example:

true

last_trigger_time
string<date-time> | null
required

Time of the last delivery attempt, successful or not, as a UTC timestamp in ISO 8601 format, or null before the first one.

Example:

"2026-08-02T14:30:00Z"

last_error
SuperagentWebhookError · object | null
required

What went wrong on the last failed delivery, or null when the last delivery succeeded or none has failed.

consecutive_failures
integer
required

Deliveries that failed in a row. After 20, Base44 turns the webhook off and sets disabled_at.

Example:

0

disabled_at
string<date-time> | null
required

Time the webhook was turned off, as a UTC timestamp in ISO 8601 format, or null while it's on. Turn it back on with enabled: true in Update Superagent webhook.

Example:

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

created_date
string<date-time>
required

Time the webhook was created, as a UTC timestamp in ISO 8601 format.

Example:

"2026-08-01T09:15:00Z"

updated_date
string<date-time>
required

Time the webhook last changed, as a UTC timestamp in ISO 8601 format.

Example:

"2026-08-02T14:30:00Z"

secret
string | null

The signing secret, returned only in the response that generates it. Store it, because no other response shows it again.

Example:

"Rk3x9QeN0vZ8bL2mT6yH4cJ1wP7sD5fG0aX9kV3uE8o"