PostifyPostify Docs

Create a webhook endpoint

Registers an HTTPS endpoint for event deliveries. The URL is validated against SSRF at creation AND re-validated at every delivery (loopback, private-network, link-local, and cloud-metadata addresses are rejected — 400 `validation_failed`). The response includes the Standard-Webhooks signing secret exactly once. Endpoint creation counts against the plan's `integrations` quota.

POST
/v1/webhook-endpoints

Registers an HTTPS endpoint for event deliveries. The URL is validated against SSRF at creation AND re-validated at every delivery (loopback, private-network, link-local, and cloud-metadata addresses are rejected — 400 validation_failed). The response includes the Standard-Webhooks signing secret exactly once. Endpoint creation counts against the plan's integrations quota.

Authorization

AuthorizationBearer <token>

Organization API key as a Bearer token (postify_live_…).

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/webhook-endpoints" \  -H "Content-Type: application/json" \  -d '{    "url": "http://example.com",    "event_types": [      "post.published"    ]  }'
{  "id": "string",  "url": "string",  "event_types": [    "post.published"  ],  "enabled": true,  "auto_disabled_at": "2019-08-24T14:15:22Z",  "consecutive_failures": -9007199254740991,  "created_at": "2019-08-24T14:15:22Z",  "signing_secret": "string"}