Skip to main content
GET
List webhooks
Returns every webhook endpoint in the workspace your API key belongs to.

Authentication

Send your API key as a bearer token.
Any workspace role can list webhooks: admin, tech, or readonly.

Request

This endpoint takes no parameters.

Response

boolean
true when the request succeeded.
object[]
The workspace’s webhook endpoints, newest first. An empty workspace returns [].
string
A human-readable summary. Do not branch on it.
Signing secrets are never returned by this endpoint. To read a secret, fetch the single webhook with GET /api/webhooks/{id} as a workspace admin.
Example response

Errors

Failures use the same envelope with success: false and the code in result.code:
Example error

Next steps

Create a webhook

Register an endpoint and get its signing secret.

Verify signatures

Check that a delivery really came from Encrata.

Inspect deliveries

See recent attempts and your endpoint’s replies.

Error reference

Every status code the API returns.