Destinations

List Destinations

Changed on

Return a list of the destinations for the tenant. The endpoint is not paged.

get/tenants/{tenant_id}/destinations

Request

  • Base URL
    https://api.outpost.hookdeck.com/2025-07-01
  • Auth
    • HTTP bearer
    • or HTTP bearer

Query parameters

'webhook' | 'aws_sqs' | 'rabbitmq' | 'hookdeck' | 'aws_kinesis' | 'azure_servicebus' | 'aws_s3' | 'gcp_pubsub' | 'kafka' | 'cloudflare_queues' | 'aws_eventbridge'

Type of destination.

OR
DestinationType[]
Example:webhook

Filter destinations by type(s). Use bracket notation for multiple values (e.g., type[0]=webhook&type[1]=aws_sqs).

string
OR
string[]

Filter destinations by supported topic(s). Use bracket notation for multiple values (e.g., topics[0]=user.created&topics[1]=user.deleted).

Response

A list of destinations.

Example response

[
  {
    "id": "des_webhook_123",
    "type": "webhook",
    "topics": [
      "user.created",
      "order.shipped"
    ],
    "disabled_at": null,
    "created_at": "2024-02-15T10:00:00Z",
    "updated_at": "2024-02-15T10:00:00Z",
    "config": {
      "url": "https://my-service.com/webhook/handler"
    },
    "credentials": {
      "secret": "whsec_abc123def456",
      "previous_secret": "whsec_prev789xyz012",
      "previous_secret_invalid_at": "2024-02-16T10:00:00Z"
    }
  }
]

Changes

    • info

      added the non-success response with the status

    • breaking

      added to the response property oneOf list for the response status

    • info

      added the enum value aws_eventbridge to the property oneOf[DestinationType]/ of the query request parameter type

    • info

      added the enum value aws_eventbridge to the property oneOf[subschema #2]/items/ of the query request parameter type

    • info

      added aws_eventbridge discriminator mapping keys to the response property for the response status