Webhook Subscriptions

Add a new signing secret (rotation)

Issue a new signing secret with the given expiry. The plaintext secret is returned in the initial response and replayed for 24 hours when the same POST is retried with the same Idempotency-Key. During the overlap window every active secret is used to sign outbound deliveries; subscribers verify against any of them.

post/webhook_subscriptions/{id}/secrets

Request

  • Base URL: https://api.kirimdev.com/v1
  • URL: https://api.kirimdev.com/v1/webhook_subscriptions/{id}/secrets
  • Auth: HTTP bearer

Path parameters

idstring required

Public Kirimdev webhook-subscription ID.

Example:wbs_01HXYZABCDEFGHJKMNPQRSTVWX

Headers

Idempotency-Keystring

Optional retry key. Reusing the same key with the same method, path, and body within 24 hours returns the original response; reusing it for a different request returns 422.

Example:order-20260910-0001

Request body

expires_in_hoursinteger

Response

New secret created

request_idstring required

Unique request identifier to include when contacting support.

Example response

{
  "request_id": "req_01HXYZABCDEFGHJKMNPQRSTVWX"
}

Changes

No recorded changes to this operation across all 1 revision of this API.