---
title: "Test Superagent webhook"
method: POST
path: "/api/agents/{agent_id}/webhooks/{webhook_id}/test"
---

# Test Superagent webhook

`POST /api/agents/{agent_id}/webhooks/{webhook_id}/test`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/agents/{agent_id}/webhooks/{webhook_id}/test`
- Auth: HTTP bearer

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

Sends a sample `message.completed` delivery to a Superagent's webhook, so you can check your endpoint.

The delivery is signed when the webhook has a secret, and carries a unique `X-Base44-Delivery` header. A successful call means the test ran, not that your endpoint accepted it. Read `ok` for that. A failed test doesn't count toward `consecutive_failures`.

Base44 waits up to 10 seconds for your endpoint to answer.

<Note>This endpoint accepts a personal API key or personal access token belonging to an editor of the agent. A read-only key is refused, and workspace API keys are not accepted.</Note>

## Path parameters

- `webhook_id` string, required: ID of the webhook to test. Get it from [List Superagent webhooks](/api-reference/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.

## Response `200`

How your endpoint answered the test.

- SuperagentWebhookTestResult: The outcome of a test delivery.
  - `ok` boolean, required: Whether your endpoint answered with a 2xx status.
  - `status_code` integer, nullable: HTTP status your endpoint answered with. Present only when it answered.
  - `response_body` string, nullable: Start of your endpoint's response body, up to 1,024 bytes. Present only when it answered.
  - `error` string, nullable: Why the delivery didn't get an answer, such as a timeout or a URL Base44 refuses to call. Present only when it didn't.

## Other responses

- `400`: `agent_id` belongs to an app that isn't a Superagent.
- `401`: Missing or invalid credentials.
- `402`: Agent webhooks need the Builder plan or higher.
- `403`: You aren't an editor of this agent, you're a viewer in its workspace, your API key is read-only, or you used a workspace API key.
- `404`: Agent or webhook not found.
- `429`: Rate limit exceeded (100 requests per minute).

## Changes

> 58 revisions in range; 1 not diffed.

- **2026-10-12** `5e139db2e643`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-10-05** `4babe63df3b7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/agents/:agent_id/webhooks/:webhook_id/test/post.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/fa29e915c226?raw)