Webhooks

Manage the endpoints that receive Senderz outbound webhooks. All endpoints use the X-Sender-Tenant + X-API-Key headers.

List endpoints

GET /api/v1/public/webhooks

Returns a raw array (not paginated) of endpoints:

string

Endpoint UUID.

name

string

Label.

url

string

Delivery URL.

events

string[]

Subscribed event types.

active

boolean

Whether it’s active.

createdAt

string

Create an endpoint

POST /api/v1/public/webhooks

url

string

required

HTTPS delivery URL (max 1000).

events

string[]

required

Non-empty list of event types from the vocabulary.

name

string

Label (max 255).

Response

Returns the endpoint object plus the signing secret — shown once:

signingSecret

string

Used to verify the X-Sender-Signature HMAC on every delivery. Store it now; it’s never returned again.

curl -X POST https://api.senderz.app/api/v1/public/webhooks \
  -H "X-Sender-Tenant: your-workspace-slug" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Order events → Zapier",
    "url": "https://hooks.example.com/senderz",
    "events": ["order.completed", "cart.abandoned"]
  }'

{
  "success": true,
  "data": {
    "id": "wh_…",
    "name": "Order events → Zapier",
    "url": "https://hooks.example.com/senderz",
    "events": ["order.completed", "cart.abandoned"],
    "active": true,
    "createdAt": "2026-01-10T12:00:00.000Z",
    "signingSecret": "whsec_…"
  }
}

Delete an endpoint

DELETE /api/v1/public/webhooks/:id

Returns 204 No Content.

For the delivery format and signature verification, see Outbound webhooks. For no-code consumption, the Make integration manages this lifecycle for you.

Messages Resource dropdowns

⌘I

Introduction

Ingest & transactional

Public API

List endpoints

Create an endpoint

Response

Delete an endpoint

​List endpoints

​Create an endpoint

​Response

​Delete an endpoint

List endpoints

Create an endpoint

Response

Delete an endpoint