Triggers

Find a trigger delivery by ID

Changed on

Finds one trigger event by its message ID or its event ID, and returns every delivery attempt made for it across every delivery endpoint in this environment, oldest first. Use this endpoint when you hold an ID from your own server: the message ID arrives as the webhook-id header, and the event ID is the payload's dedupe_key. Pass the ID in the path. Attempt IDs (atmpt_) are not accepted. Only this environment's deliveries are searched, so an ID from another environment is reported as not found. Returns the event's message ID, event ID and creation time, the trigger subscription, trigger and connection it came from while they still exist, and its attempts, each naming the endpoint and URL it was sent to, with response bodies cut to their first 4096 bytes. Returns at most 50 attempts, the newest 50; truncated is true when the event has more. The event payload is never returned.

get/api/v1/trigger-delivery/deliveries/{id}

Request

Path parameters

idstring required

The message ID (msg_…, sent to the endpoint as the webhook-id header) or the event ID (the payload's dedupe_key) of the trigger event to find. 1 to 256 characters: letters, digits, ., _ and -. An attempt ID (atmpt_…) is refused.

Response

The event, with its message ID, event ID and creation time, the trigger and connection it came from, and its delivery attempts to every endpoint, oldest first

connection_idstring

ID of the connection the event came from. Present even after the connection is deleted. Empty when the event carries none.

connection_key_idstring

Key ID of the connection the event came from. Empty when the connection no longer exists.

connection_providerstring

Provider of the connection the event came from. Empty when the connection no longer exists.

event_idstring

Event ID of the event: the payload's dedupe_key and correlation_id. Empty when the event was sent without one.

message_timestampstring date-time

When the event was accepted for delivery.

msg_idstring

Message ID of the event, sent to each endpoint as the webhook-id header.

subscription_idstring

ID of the trigger subscription that sent the event. Present even after the subscription is deleted. Empty when the event carries none.

trigger_mode'WEBHOOK' | 'POLL'

How a trigger detects that something happened.

  • WEBHOOK: The provider posts to a Scalekit URL when the event occurs.
  • POLL: Scalekit walks the provider's list on a cadence.
trigger_namestring

Key of the trigger that fired, as the subscription was created with. Empty when the subscription no longer exists.

truncatedboolean

True when the event has more than the 50 attempts returned. The newest 50 are returned, so the earliest attempts are missing when this is true.

Example response

{
  "attempts": [
    {
      "endpoint_id": "ep_123456789012345",
      "endpoint_url": "https://agent.example.com/hooks/triggers",
      "id": "atmpt_123456789012345",
      "msg_id": "msg_123456789012345",
      "response": "{\"ok\":true}",
      "response_duration_ms": 182,
      "response_status_code": 200,
      "timestamp": "2026-10-09T12:34:56Z"
    }
  ],
  "connection_id": "conn_28128748834787840",
  "connection_key_id": "salesforce-acme",
  "connection_provider": "SALESFORCE",
  "event_id": "ca_5F28128748834787840.trgs_5F28128748834787841.Ev07ABCDEF12",
  "message_timestamp": "2026-10-09T12:34:55Z",
  "msg_id": "msg_2yAqUxVq4mTt8jHZ3fWbKcN1Pd0",
  "subscription_id": "trgs_28128748834787841",
  "trigger_name": "slack_message_posted"
}

Changes