Send a test ping to a webhook endpoint

Sends a signed ping event to the endpoint (works for both organization-scoped and partner-level endpoints — whk_ IDs are unique across your partner account). Use it to verify your signature handling end to end.

Authentication

AuthorizationBearer
Partner API key sent as `Authorization: Bearer cfk_...`. Keys are partner-level — one key reaches every registry linked to your partner account and nothing else. CONFIRM issues and revokes them; a key is shown exactly once at creation because only its hash is stored, and revocation takes effect on the next request. Develop against the sandbox base URL with a sandbox key, where telephony is restricted to an allowlist you provide.

Path parameters

whk_idstringRequired

Webhook endpoint ID (whk_...).

Headers

Idempotency-KeystringOptional<=255 characters

Unique key (e.g. a UUID) making this POST safe to retry. Replays within 24 hours return the original response without repeating side effects.

Response

Ping event queued for delivery; returns the event envelope that will be sent.

idstringOptional

Event ID (evt_...).

typeenumOptional

Webhook/event-log event type.

createddatetimeOptional
When the event occurred.
org_idstringOptional
Organization the event belongs to.
external_refstring or nullOptional

The related candidate’s external_ref, echoed on every event for correlation; null for ping.

dataobjectOptional

Errors

401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error