hail.sodocs
POST
/v1/webhooks/{sub_id}/rotate-secret

Path Parameters

sub_id*Sub Id
Formatuuid

Header Parameters

authorization?string|null

Response Body

application/json

application/json

curl -X POST "https://example.com/v1/webhooks/497f6eca-6276-4993-bfeb-53cbbbba6f08/rotate-secret"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",  "target_url": "string",  "event_types": [    "string"  ],  "status": "active",  "consecutive_failures": 0,  "last_success_at": "2019-08-24T14:15:22Z",  "last_failure_at": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "secret": "string"}

Release Number

Release a dedicated number. The monthly fee stops accruing after the release month; months already accrued stay owed (the rater bills late, never forgives).

Unsubscribe

One-click email opt-out (RFC 8058), reached by clicking a link in a sent email. Public and unauthenticated — the signed token query param is the sole credential, proving the caller holds a link Hail sent to that address. On success, the address is added to the org's suppression list and all future outbound email to it is blocked. Returns an HTML page, not JSON.