Docs / Strand / connectors/azure-service-bus

Azure Service Bus

Direction: Write Only | Type: azure.servicebus

Azure Service Bus connector for sending messages to queues or topics. This is a forward-only connector.

Required Permissions#

The connection string's Shared Access Policy must include the following claims, or the service principal must have the corresponding RBAC role:

Operation	Required Claim / Azure Role
`send`	Send claim, or Azure Service Bus Data Sender role

Tip: Assign at the namespace or individual queue/topic level. Avoid using the Manage claim unless you need administrative access.

Operation	Direction	Description
`send`	Write	Send a message to a queue or topic

Field	Required	Default	Description
Authentication Type	No	`api_key`	Uses explicit credentials (the fields below).
Connection String	Conditional	-	Azure Service Bus connection string (encrypted). Required when Authentication Type is `api_key`
Namespace	Conditional	-	Fully qualified namespace (e.g., `myns.servicebus.windows.net`), used in place of a connection string
Queue Name	No	-	Default queue name (use for queue-based messaging)
Topic Name	No	-	Default topic name (use for topic/subscription messaging)

Tip

Specify either a Queue Name or Topic Name, not both. The connector routes the message to the appropriate destination.

Field	Required	Description
Queue Name	No	Queue name (overrides connector default)
Topic Name	No	Topic name (overrides connector default)

json


{
  "success": true,
  "status": "sent",
  "data": {
    "queue": "my-queue"
  },
  "service": "azure.servicebus",
  "operation": "send"
}

Connector Setup:

json


{
  "connection_string": "Endpoint=sb://mynamespace.servicebus.windows.net/;SharedAccessKeyName=...",
  "queue_name": "order-processing"
}