StatusDashboard
WebhooksInboundKeys

List webhook keys

List all inbound webhook signing keys for the organization.

View Markdown

GET /app/integrations/webhooks/inbound/keys

Returns all webhook signing keys for the organization, along with the maximum number of keys allowed by the plan. The raw signing secret is never returned after creation.

Requires the integrations feature entitlement.


Request

See API Basics for required headers.

This endpoint takes no request body or query parameters.


Sample request

curl https://api.statusdashboard.com/app/integrations/webhooks/inbound/keys \
  -H "Authorization: Bearer bcf847abf5c6:def456"

Sample response

Status: 200 OK

{
  "keys": [
    {
      "keyId": "wk_a1b2c3d4e5f6a7b8",
      "name": "CRM integration",
      "createdAt": "2026-03-20T10:00:00.000Z",
      "lastUsedAt": "2026-04-14T09:15:00.000Z"
    }
  ],
  "maxKeys": 5
}

lastUsedAt is omitted when the key has never been used.


Response fields

FieldTypeDescription
keysarrayInbound webhook signing keys for the organization. The raw secret is never returned after create.
maxKeysnumberMaximum keys allowed on your plan.
keys[].keyIdstringPublic key identifier sent in inbound webhook requests.
keys[].namestringHuman-readable label from create.
keys[].createdAtstringISO 8601 timestamp when the key was created.
keys[].lastUsedAtstring | omittedISO 8601 timestamp of the most recent authenticated ingest. Omitted when never used.

Error responses

StatusWhen
403Insufficient permissions, or the integrations feature is not enabled.

On this page

We use cookies

We use essential cookies to keep the site working, and optional analytics cookies to understand how it's used. Read our Privacy Policy.