message.received

Delivered once per recipient when a new inbound message is received from a number Fortress recognizes.

Fortress POSTs this payload to the URL configured for your subscription. See Webhooks for delivery, signing and retry rules, and the event page for when it does and does not fire.

Delivered once per recipient when a new inbound message is received from a number Fortress recognizes. Fortress POSTs this payload to the URL configured for your subscription. See [Webhooks](/webhooks/webhooks) for delivery, signing and retry rules, and the [event page](/webhooks/webhook-events/webhooks/message-received) for when it does and does not fire.

Payload

The payload of this webhook request is an object.

eventIdstringRequiredformat: "uuid"

Unique identifier for this event. Stable across delivery attempts, so consumers must dedupe on this value. Also sent as the X-Fortress-Event-Id header.

eventTypeenumRequired

What happened, in resource.action form. Also sent as the X-Fortress-Event-Type header. New values are added over time.

Allowed values:

occurredAtdatetimeRequired

ISO-8601 UTC timestamp of when the event occurred, not when it was delivered. A retried delivery carries the original occurredAt.

dataobjectRequired

Event payload. The shape is determined by eventType.

Response

200

Acknowledged. Return 2xx within the delivery timeout or Fortress retries.