Webhooks

List webhook delivery logs (organization)

Paginated **webhook delivery logs** for your organization (each row is one outbound HTTP attempt). Optional **`projectId`** query filters to a project that belongs to your org. Use each log document’s **`_id`** (MongoDB ObjectId) as **`webhookId`** when calling **`POST /api/webhooks/retry/{webhookId}`** after a failed delivery. Organization **JWT only** (`OrgBearerAuth`); project API keys are not accepted on this route.

AuthBearer (JWT)
GroupWebhooks
Rate limitSee Rate Limits
GET/api/webhooks

SDK setup

Create a client and set credentials (JWT and/or API key) before calling the API. Match the authentication type shown above.

import { Configuration, WebhooksApi } from 'mudbase-sdk';

const configuration = new Configuration({
  basePath: 'https://cloud.mudbase.dev',
  accessToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c3JfbW9yZ2FuX2RlIiwiZW1haWwiOiJtb3JnYW4uY2hlbkBub3J0aHdpbmQuZGV2IiwiZXhwIjoxODI1MTI5NjAwfQ.doc_preview_sig',
});

const webhooks = new WebhooksApi(configuration);
import { Configuration, WebhooksApi } from 'mudbase-sdk';

const configuration = new Configuration({
  basePath: 'https://cloud.mudbase.dev',
  accessToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c3JfbW9yZ2FuX2RlIiwiZW1haWwiOiJtb3JnYW4uY2hlbkBub3J0aHdpbmQuZGV2IiwiZXhwIjoxODI1MTI5NjAwfQ.doc_preview_sig',
});

const webhooks = new WebhooksApi(configuration);

Example request

Call this endpoint using the client from SDK setup. Use View HTTP for a raw cURL example.

const { data: result } = await webhooks.listWebhooks();
const { data: result } = await webhooks.listWebhooks();

Playground

live

Test this endpoint with your own credentials. Your requests will be sent to the live API.

Use the auth endpoints to obtain a JWT.

No Request Yet

Send a request to see the full inspector

Authentication

Requires JWT
Note
Include your JWT in the Authorization: Bearer YOUR_TOKEN header (user-facing apps, RBAC). View authentication guide →

Query Parameters

NameTypeRequiredDescription
pageintegerNo—
limitintegerNo—
statusstringNo—
eventstringNo—
projectIdstringNoOptional; restrict logs to this project (must belong to your org).

Responses

200Webhook delivery logs
json
{
  "webhooks": [
    {
      "_id": "685af3992f9c4c96514247e9",
      "org": "65a1b2c3d4e5f6789012345a",
      "project": "65a1b2c3d4e5f6789012345b",
      "webhookId": "manual-1712140800123",
      "event": "custom.test",
      "url": "https://example.com/webhook",
      "method": "POST",
      "status": "success",
      "attempts": 1,
      "duration": 142,
      "payload": {
        "hello": "world"
      },
      "response": {
        "status": 200,
        "body": {
          "ok": true
        }
      },
      "headers": {
        "Content-Type": "application/json",
        "User-Agent": "MUDBASE-Webhook/1.0",
        "X-MUDBASE-Event": "custom.test",
        "X-MUDBASE-Project": "65a1b2c3d4e5f6789012345b"
      },
      "createdAt": "2026-04-03T10:00:00.000Z",
      "updatedAt": "2026-04-03T10:00:00.200Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20,
  "totalPages": 1
}
{
  "webhooks": [
    {
      "_id": "685af3992f9c4c96514247e9",
      "org": "65a1b2c3d4e5f6789012345a",
      "project": "65a1b2c3d4e5f6789012345b",
      "webhookId": "manual-1712140800123",
      "event": "custom.test",
      "url": "https://example.com/webhook",
      "method": "POST",
      "status": "success",
      "attempts": 1,
      "duration": 142,
      "payload": {
        "hello": "world"
      },
      "response": {
        "status": 200,
        "body": {
          "ok": true
        }
      },
      "headers": {
        "Content-Type": "application/json",
        "User-Agent": "MUDBASE-Webhook/1.0",
        "X-MUDBASE-Event": "custom.test",
        "X-MUDBASE-Project": "65a1b2c3d4e5f6789012345b"
      },
      "createdAt": "2026-04-03T10:00:00.000Z",
      "updatedAt": "2026-04-03T10:00:00.200Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20,
  "totalPages": 1
}
400—
403—
500—

Errors

CodeMeaning
400—
403—
500—
Run in PostmanDownload OpenAPI

Next

NEXT →API Reference OverviewBase URL, rate limits, pagination, and the full endpoint index.NEXT →AuthenticationAPI keys, Bearer tokens, and user sessions.NEXT →API PlaygroundSearch any endpoint and send a live request.
Edit this page on GitHub