Private beta — invite only. Request access
ForjioHuudisIdentityPlugipayPaymentsStorlaunchE-commerceFulkrumaFulfillmentRiplloMarketingSecronnaThis product
Secronna Docs
⌘K

Webhooks

Generated from Secronna's own code: every route in this area, what it takes and how to call it.

Method Path What it does
GET /api/v1/webhooks List the workspace's webhook endpoints.
POST /api/v1/webhooks Register a webhook endpoint.
DELETE /api/v1/webhooks/{id} Delete a webhook endpoint and its delivery log.
PATCH /api/v1/webhooks/{id} Change a webhook endpoint: url, events, description, or enabled. enabled: false pauses it (its queued deliveries fail); enabled: true re-enables it, also after Secronna switched it off for failing, an
GET /api/v1/webhooks/{id}/deliveries One endpoint's recent deliveries (newest first), each with its attempts.
GET /api/v1/webhooks/event-types The event types an endpoint can subscribe to.

List the workspace's webhook endpoints.

GET /api/v1/webhooks

List the workspace's webhook endpoints. Never the signing secret, only its hint.

Example

curl -X GET "https://secronna.com/api/v1/webhooks" \
  -H "Authorization: Bearer st_…"

Register a webhook endpoint.

POST /api/v1/webhooks

Register a webhook endpoint. The URL must be https and must not resolve to a private, loopback or link-local address. The response is the only time the signing secret (whsec_…) is returned.

Body

Field Type Required Notes
url string yes min length 1; max length 2048
events array of secronna.secret.create or secronna.secret.rotate or secronna.secret.reveal or secronna.secret.delete or secronna.webhook_endpoint.disabled yes
description string no max length 280

Example

curl -X POST "https://secronna.com/api/v1/webhooks" \
  -H "Authorization: Bearer st_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"…","events":[],"description":"…"}'

Delete a webhook endpoint and its delivery log.

DELETE /api/v1/webhooks/{id}

Path parameters

Name Type Required Notes
id string yes

Example

curl -X DELETE "https://secronna.com/api/v1/webhooks/:id" \
  -H "Authorization: Bearer st_…"

Change a webhook endpoint: url, events, description, or enabled. enabled: false pauses it (its queued deliveries fail); enabled: true re-enables it, also after Secronna switched it off for failing, an

PATCH /api/v1/webhooks/{id}

Change a webhook endpoint: url, events, description, or enabled. enabled: false pauses it (its queued deliveries fail); enabled: true re-enables it, also after Secronna switched it off for failing, and clears its failure streak. The signing secret never changes.

Path parameters

Name Type Required Notes
id string yes

Body

Field Type Required Notes
url string no min length 1; max length 2048
events array of secronna.secret.create or secronna.secret.rotate or secronna.secret.reveal or secronna.secret.delete or secronna.webhook_endpoint.disabled no
description string no max length 280; may be null
enabled boolean no

Example

curl -X PATCH "https://secronna.com/api/v1/webhooks/:id" \
  -H "Authorization: Bearer st_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"…","events":[],"description":"…","enabled":false}'

One endpoint's recent deliveries (newest first), each with its attempts.

GET /api/v1/webhooks/{id}/deliveries

Path parameters

Name Type Required Notes
id string yes

Query parameters

Name Type Required Notes
limit any no

Example

curl -X GET "https://secronna.com/api/v1/webhooks/:id/deliveries" \
  -H "Authorization: Bearer st_…"

The event types an endpoint can subscribe to.

GET /api/v1/webhooks/event-types

Example

curl -X GET "https://secronna.com/api/v1/webhooks/event-types" \
  -H "Authorization: Bearer st_…"