Astrocal
API ReferenceWebhooksV1WebhooksId

Delete a webhook endpoint

Permanently deletes a webhook endpoint and all its delivery records. This action cannot be undone.

DELETE
/v1/webhooks/{id}

Authorization

BearerAuth
AuthorizationBearer <token>

API key authentication. Use your API key as the bearer token.

In: header

Path Parameters

id*string

Response Body

application/json

application/json

curl -X DELETE "https://example.com/v1/webhooks/497f6eca-6276-4993-bfeb-53cbbbba6f08"
Empty
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

Create a webhook endpoint

Creates a new webhook endpoint for the authenticated organization. The signing secret is returned in the response — this is the only time it will be shown. Use the secret to verify webhook signatures via the `X-Astrocal-Signature` header. Astrocal immediately POSTs a verification challenge to the URL, which your endpoint must echo back. The endpoint receives no events until `verification_status` is `verified`. Creation always succeeds — check `verification_status` in the response and retry with `POST /v1/webhooks/{id}/verify` if it is not yet verified. An organization may hold at most 50 webhook endpoints.

Update a webhook endpoint

Partially updates a webhook endpoint. Only the provided fields are updated. The signing secret cannot be changed.