Destinations
Destinations allow you to fan out webhook events to multiple systems beyond your primary delivery_url. Use them for alerting, logging, or routing events to additional services.
How Destinations Work
Section titled “How Destinations Work”Destinations are triggered after the primary delivery cycle:
- On successful primary delivery (if no condition is set, or the condition matches)
- After exhausted retries when
delivery_failedistrue(useful for failure alerts)
Each destination can have a condition expression that determines when it fires.
Destination Types
Section titled “Destination Types”| Type | Description |
|---|---|
| Webhook | POST to any URL, optionally with HMAC signing |
| Send notifications via Amazon SES | |
| Slack | Send formatted messages to a Slack channel |
| Discord | Send formatted embeds to a Discord channel |
Managing Destinations
Section titled “Managing Destinations”Destinations are attached to provider accounts. Use the Destinations API to create and manage them:
# List destinations for an accountcurl https://ingest.transyt.com/admin/accounts/{account_id}/destinations \ -H "X-Admin-Token: YOUR_ADMIN_TOKEN"
# Create a Slack destinationcurl -X POST https://ingest.transyt.com/admin/accounts/{account_id}/destinations \ -H "X-Admin-Token: YOUR_ADMIN_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "destination_type": "slack", "name": "Slack Alerts", "config": { "webhook_url": "https://hooks.slack.com/services/T.../B.../xxx" }, "condition": "delivery_failed" }'Ordering
Section titled “Ordering”Destinations have a position field that determines the order in which they are evaluated. Lower positions are evaluated first.