Azure Service Bus

Send events to an Azure Service Bus queue or topic.

Creating an Azure Service Bus Destination

curl 'https://api.outpost.hookdeck.com/2025-07-01/tenants/<TENANT_ID>/destinations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_KEY>' \
--data '{
  "type": "azure_servicebus",
  "topics": ["orders"],
  "config": {
    "name": "my-queue"
  },
  "credentials": {
    "connection_string": "Endpoint=sb://my-namespace.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=<KEY>"
  }
}'

Configuration

Config

FieldTypeRequiredDescription
config.namestringYesThe Service Bus queue or topic name

Credentials

FieldTypeRequiredDescription
credentials.connection_stringstringYesAzure Service Bus connection string

Message Format

Events are sent as Service Bus messages:

  • Body: The event's data field as JSON
  • Application Properties: System metadata (event-id, topic, timestamp) plus any event metadata from the published event

Example

Publishing this event:

{
  "topic": "orders",
  "data": { "order_id": "123", "status": "created" },
  "metadata": { "source": "checkout-service" }
}

Results in a Service Bus message with:

Body:

{"order_id": "123", "status": "created"}

Application Properties:

PropertyValue
event-idevt_123
topicorders
timestamp1704067200
sourcecheckout-service

Getting a Connection String

  1. Navigate to your Service Bus namespace in the Azure Portal
  2. Go to Shared access policies
  3. Select or create a policy with Send permission
  4. Copy the Primary Connection String