BAbase44

List Superagent webhooks

Changed on

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Lists a Superagent's webhooks, newest first.

Each webhook shows whether deliveries are signed (has_secret), never the secret itself.

<Note>This endpoint accepts a personal API key or personal access token belonging to an editor of the agent, including a read-only one. Workspace API keys are not accepted.</Note>

get/api/agents/{agent_id}/webhooks

Request

  • Base URL
    https://app.base44.com
  • URL
    https://app.base44.com/api/agents/{agent_id}/webhooks
  • Auth
    HTTP bearer

Path parameters

agent_idstring required

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

Response

The agent's webhooks.

idstring required

ID of the webhook.

target_urlstring required

HTTPS URL Base44 sends the events to.

eventsstring[] 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.

descriptionstring nullable required

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

has_secretboolean required

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

last_trigger_timestring date-time nullable required

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

consecutive_failuresinteger required

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

disabled_atstring date-time nullable 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.

created_datestring date-time required

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

updated_datestring date-time required

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

Example response

[
  {
    "id": "68a1d0f4f0b9d3002e7a5c52",
    "target_url": "https://example.com/hooks/agent",
    "events": [
      "message.completed"
    ],
    "description": "CRM sync",
    "has_secret": true,
    "last_trigger_time": "2026-08-02T14:30:00Z",
    "last_error": {
      "message": "Non-2xx response: 500",
      "attempted_at": "2026-08-02T14:30:00+00:00",
      "status_code": 500,
      "response_body": "Internal Server Error",
      "error_type": "ConnectTimeout"
    },
    "disabled_at": "2026-08-03T08:00:00Z",
    "created_date": "2026-08-01T09:15:00Z",
    "updated_date": "2026-08-02T14:30:00Z"
  }
]

Changes

  • 32455e516133Revision changes
    • info

      the security scope read_only was added to the endpoint's security scheme PersonalAccessTokenAuth

    • info

      the security scope full_access was removed from the endpoint's security scheme PersonalAccessTokenAuth

  • 80287813ab84Revision changes
    • info

      the endpoint scheme security PersonalAccessTokenAuth was added to the API