Docs / Contact / connectors/azure-service-bus

Azure Service Bus

Provider: azure | Service: servicebus | Direction: Write

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

Required Permissions#

The connection string's Shared Access Policy must include the Send claim, or (for role auth) the Contact service principal must have the Azure Service Bus Data Sender role.

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

Operation#

When a message reaches this connector, it sends to the queue or topic named in the payload. The payload must supply:

Payload field Required Description
destination Yes Target queue or topic name
message Yes Message body to send

Connector Configuration#

The connector is created with type: "cloud", provider: "azure", service_type: "servicebus", plus:

Field (config) Required Description
service_bus_conn Yes Service Bus connection string (use ${secrets.servicebus_conn}).

Output#

json

{
  "status": "completed",
  "data": {
    "status": "sent",
    "destination": "device-events"
  }
}

Example#

Connector config (connection string):

json

{
  "type": "cloud",
  "provider": "azure",
  "service_type": "servicebus",
  "service_bus_conn": "${secrets.servicebus_conn}"
}