Skip to main content
GET
List Superagent webhooks

Authorizations

Authorization
string
header
required

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

Path Parameters

agent_id
string
required

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

Response

The agent's webhooks.

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"