Webhooks

Get webhook HMAC status

Retrieve the current HMAC signing configuration for webhooks.

Note: The HMAC secret is never returned - only the configuration status is shown.

get/v1/webhook/hmac

Request

  • Base URL: https://api.handoff.ai
  • URL: https://api.handoff.ai/v1/webhook/hmac
  • Auth: HTTP bearer

Response

HMAC configuration retrieved successfully

enabledboolean required

Whether HMAC signing is enabled for webhooks

algorithmstring required

HMAC algorithm used for signing

headerNamestring required

HTTP header containing the signature

timestampHeaderNamestring required

HTTP header containing the timestamp

Example response

{
  "enabled": true,
  "algorithm": "sha256",
  "headerName": "X-Handoff-Signature",
  "timestampHeaderName": "X-Handoff-Timestamp"
}

Changes

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