Skip to main content

TriggerResponse

Acknowledgement that an event was accepted and queued for delivery.

A 202 does not mean the notification was delivered — it means Nerve has durably accepted responsibility for it. Delivery outcomes arrive as delivery receipts on your webhook endpoint.

channelstringrequired

The channel this event was queued on, chosen from the contact details supplied and the resolved priority. Urgent events take the most reachable channel, everything else the cheapest.

One of sms, email, push, whatsapp or voice. The workers may still fail over to another channel if every provider on this one rejects the message; the delivery receipt reports what actually happened.

Example: email
eventIdstringrequired

Nerve's identifier for this event. Quote it in support requests and use it to correlate delivery receipts.

Example: evt_9c4f1a2b3d5e6f708192a3b4c5d6e7f8
idempotencyKeystring | nullnullable

Echo of the Idempotency-Key header, when one was supplied.

prioritystringrequired

Resolved priority, after applying the X-Priority-Override header.

Example: NORMAL
statusstringrequired

Always QUEUED on a fresh acceptance.

Example: QUEUED
timestampstringrequired

RFC 3339 timestamp of acceptance.

Example: 2026-08-28T09:15:04.221Z
TriggerResponse
{
  "channel": "email",
  "eventId": "evt_9c4f1a2b3d5e6f708192a3b4c5d6e7f8",
  "idempotencyKey": "string",
  "priority": "NORMAL",
  "status": "QUEUED",
  "timestamp": "2026-08-28T09:15:04.221Z"
}