{"id":20697571,"url":"https://github.com/epomatti/servicebus-postman-collection","last_synced_at":"2026-04-26T08:33:00.919Z","repository":{"id":108713392,"uuid":"551703691","full_name":"epomatti/servicebus-postman-collection","owner":"epomatti","description":"A boilerplate Postman collection to quickly start working with Azure Service Bus REST API","archived":false,"fork":false,"pushed_at":"2022-10-15T14:09:50.000Z","size":79,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-11T02:51:15.976Z","etag":null,"topics":["az-cli","azure","postman","rest-api","servicebus"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/epomatti.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-14T23:28:45.000Z","updated_at":"2024-04-25T16:10:03.000Z","dependencies_parsed_at":"2023-04-06T12:17:40.555Z","dependency_job_id":null,"html_url":"https://github.com/epomatti/servicebus-postman-collection","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/epomatti/servicebus-postman-collection","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epomatti%2Fservicebus-postman-collection","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epomatti%2Fservicebus-postman-collection/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epomatti%2Fservicebus-postman-collection/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epomatti%2Fservicebus-postman-collection/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/epomatti","download_url":"https://codeload.github.com/epomatti/servicebus-postman-collection/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/epomatti%2Fservicebus-postman-collection/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260924470,"owners_count":23083522,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["az-cli","azure","postman","rest-api","servicebus"],"created_at":"2024-11-17T00:19:03.092Z","updated_at":"2026-04-26T08:32:55.898Z","avatar_url":"https://github.com/epomatti.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Service Bus - Postman client\n\nThis is a Postman boilerplate collection to use **Azure Service Bus REST API** as detailed in the [official docs][1].\n\n\u003cimg src=\"assets/header.png\" /\u003e\n\nYou'll find the Azure CLI instructions below to setup the required resources that Postman will need. You can also create the resources with the Azure Portal and just use the Postman collection.\n\n## Setup\n\nPostman will need an App Registration to authenticate and send messages to Service Bus using access tokens.\n\nSteps to setup the Postman client:\n\n1. Create an App Registration on Azure AD with a client secret + Service Principal\n2. Assign the desired Service Bus RBAC to the Service Principal.\n3. Configure the Postman collection to connect to Azure AD and Service Bus.\n\nIdentify the values marked as `{...}` that need to be replaced.\n\n### 1 - Create the App Registration\n\n```sh\n# Creates an app registration (ex: postman-servicebus-dev)\naz ad app create --display-name \"{name}\" --query appId -o tsv\n\n# Create a secret ---\u003e 💡 save the output for later\naz ad app credential reset --append --display-name postman --id \"{APP ID}\"\n\n# Create the service principal\naz ad sp create --id \"{APP ID}\" --query id -o tsv\n```\n\n### 2 - Assign permissions for the **Service Principal** to send messages to Service Bus\n\n```sh\n# Get the Service Bus resource id\naz servicebus namespace show -n \"{SERVICEBUS NAMESPACE}\" -g \"{RESOURCE GROUP}\" --query id -o tsv\n\n# Assign the permission\naz role assignment create --assignee \"{SERVICE PRINCIPAL ID}\" \\\n  --role 69a216fc-b8fb-44d8-bc22-1f3c2cd27a39 \\\n  --scope \"{SERVICE BUS RESOURCE ID}\"\n```\n\n\u003e ℹ️ Optionally, you can add `Azure Service Bus Data Receiver` or even `Azure Service Bus Data Owner` depending no your needs. Check out Azure RBAC [built-in roles][3].\n\n### 3 - Configure Postman \u0026 Send messages\n\nDownload and import both the **Collection** and the **Environment** boilerplate files from this repository that are available under the [./postman](/postman/) folder.\n\n#### 3.1 Set the environment variables\n\nSet the required values so Postman can authenticate and send messages. You'll add the dynamic values that were generated and your Service Bus namespace name and queues.\n\n\u003cimg src=\"assets/environment.png\" /\u003e\n\n#### 3.2 - Authenticate\n\nSelect the environment on Postman. First you need to authenticate and generate a token:\n\n\u003e 💡The token will be automatically saved to the context in the `{{access_token}}` variable on Postman\n\n\u003cimg src=\"assets/token.png\" /\u003e\n\n#### 3.3 - Send Messages\n\n✅ You can now send messages to Service Bus.\n\n\u003cimg src=\"assets/sendmessage.png\" /\u003e\n\nI've added a batch request there as well. You might want to check Service Bus [REST API][2] for more operations, options, and troubleshooting.\n\n## Contributing\n\nFeel free to send a PR for new operations that you find useful for your use cases and complement this collection.\n\n[1]: https://learn.microsoft.com/en-us/rest/api/servicebus/get-azure-active-directory-token\n[2]: https://learn.microsoft.com/en-us/rest/api/servicebus/service-bus-runtime-rest\n[3]: https://learn.microsoft.com/en-us/azure/role-based-access-control/built-in-roles\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fepomatti%2Fservicebus-postman-collection","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fepomatti%2Fservicebus-postman-collection","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fepomatti%2Fservicebus-postman-collection/lists"}