Azure Web PubSub website screenshot

Azure Web PubSub

Azure Web PubSub is a fully-managed service that enables building real-time, two-way messaging applications using publish-subscribe patterns over WebSockets. It supports broadcasting messages to clients in groups, sending messages to specific connections or users, and integrating with serverless event handlers for scalable real-time experiences.

Azure Web PubSub publishes 4 APIs on the APIs.io network, including Client and Upstream Events, ClientToken API, Hub API, and 1 more. Tagged areas include Messaging, Pub-Sub, Real-Time, Serverless, and WebSockets.

The Azure Web PubSub catalog on APIs.io includes 1 event-driven AsyncAPI specification and 1 Spectral governance ruleset.

Azure Web PubSub’s developer surface includes authentication, developer portal, documentation, getting-started guide, pricing, engineering blog, support, and 37 more developer resources.

61.0/100 strong ▼ -7.9 Agent 36/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
8 APIs
MessagingPub-SubReal-TimeServerlessWebSockets

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 61.0/100 · strong
Contract Quality 15.9 / 25
Developer Ergonomics 11.3 / 20
Commercial Clarity 16.8 / 20
Operational Transparency 8.9 / 13
Governance 5.7 / 12
Discoverability 8.2 / 10
Agent readiness — 36/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/microsoft-azure-web-pubsub: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 8

Individual APIs this provider publishes, each with its own machine-readable definition.

Azure Web PubSub Client and Upstream Events

AsyncAPI 2.6 description of the Azure Web PubSub client WebSocket subprotocols (json.webpubsub.azure.v1 and json.reliable.webpubsub.azure.v1) and the CloudEvents 1.0 HTTP upstre...

Azure Web PubSub Hubs REST API

REST API for managing hub configurations within a Web PubSub instance. Hubs provide logical isolation for messaging and allow per-hub configuration of event handlers, anonymous ...

Azure Web PubSub for Socket.IO REST API

REST API for managing Azure Web PubSub for Socket.IO instances. Provides a fully managed Socket.IO server replacement that allows existing Socket.IO applications to scale to mil...

Azure Web PubSub Private Endpoint Connections REST API

REST API for managing private endpoint connections to a Web PubSub service instance. Enables secure, private connectivity from virtual networks to Web PubSub through Azure Priva...

Azure Web PubSub Shared Private Link Resources REST API

REST API for managing shared private link resources for a Web PubSub service. Enables outbound private connectivity from Web PubSub to other Azure resources such as Key Vault an...

Azure Web PubSub ClientToken API

Generate JWT tokens for client connections

Azure Web PubSub Hub API

Send messages and manage connections, groups, and users in a hub

Azure Web PubSub Permission API

Permission management for client connections

Scroll for all 8

Postman Collections 3

Ready-to-run Postman collections for exercising this provider's APIs.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Arazzo Workflows 12

Multi-step API workflows described with the Arazzo specification.

Azure Web PubSub Check then Close Connection

Verify a connection exists before closing it, branching on whether it is present.

ARAZZO

Azure Web PubSub Direct Connection Message

Confirm a connection exists, then send a targeted message to just that connection.

ARAZZO

Azure Web PubSub Grant Permission then Send to User

Grant a connection a group permission, then deliver a message to that user.

ARAZZO

Azure Web PubSub Grant Permission if Missing

Check whether a connection already holds a permission, granting it only when absent.

ARAZZO

Azure Web PubSub Broadcast to Group if Active

Only broadcast to a group when it currently has connected members.

ARAZZO

Azure Web PubSub Warn Group and Tear Down

Broadcast a final warning to a group, then close every connection in that group.

ARAZZO

Azure Web PubSub Join Group, Send, then Leave

Add a connection to a group, broadcast a message to that group, then remove the connection.

ARAZZO

Azure Web PubSub Notify User if Online

Send a user a message only when they currently have at least one live connection.

ARAZZO

Azure Web PubSub Provision Client and Join Group

Mint a client token, add the connection to a group, and announce the join to that group.

ARAZZO

Azure Web PubSub Revoke Permission and Evict Connection

Revoke a connection's group permission, then forcibly close that connection.

ARAZZO

Azure Web PubSub Generate Token then Broadcast

Mint a client access token for a hub and immediately broadcast a message to every connection.

ARAZZO

Azure Web PubSub Onboard User to Group

Add a user to a group and welcome them with a targeted message in one flow.

ARAZZO

Scroll for all 12

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

FinOps 1

Cost, billing, and metering signals for API financial operations.

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Azure Web PubSub

Azure Web PubSub is a fully managed real-time messaging service from Microsoft Azure that lets clients exchange publish/subscribe messages over WebSockets without operating WebS...

ASYNCAPI

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Azure Web PubSub API Rules

8 rules · 1 errors 6 warnings 1 info

SPECTRAL

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Microsoft Azure Web Pubsub Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Microsoft Azure Web Pubsub Agentic Access

19 operations · 15 acting · 1 human-in-the-loop

19 operations · 15 acting

AGENTIC

Resources

Get Started 4

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 12

Pagination, idempotency, versioning, errors, and events

Scroll for all 12

Build 10

SDKs, sample code, and the tooling you integrate with

Scroll for all 10

Access & Security 3

Authentication, authorization, and security posture

Operate 7

Status, limits, changes, and where to get help

Scroll for all 7

Commercial 4

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
name: Azure Web PubSub
description: Azure Web PubSub is a fully-managed service that enables building real-time, two-way messaging applications using
  publish-subscribe patterns over WebSockets. It supports broadcasting messages to clients in groups, sending messages to
  specific connections or users, and integrating with serverless event handlers for scalable real-time experiences.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://azure.microsoft.com/svghandler/web-pubsub/
tags:
- Messaging
- Pub-Sub
- Real-Time
- Serverless
- WebSockets
created: '2026-03-13'
modified: '2026-05-30'
url: https://azure.microsoft.com/en-us/services/web-pubsub/
specificationVersion: '0.18'
apis:
- name: Azure Web PubSub Client and Upstream Events
  description: AsyncAPI 2.6 description of the Azure Web PubSub client WebSocket subprotocols (json.webpubsub.azure.v1 and
    json.reliable.webpubsub.azure.v1) and the CloudEvents 1.0 HTTP upstream contract used by the service to deliver client
    events (connect, connected, disconnected, message, user custom events) to a configured backend webhook.
  image: https://azure.microsoft.com/svghandler/web-pubsub/
  humanURL: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/reference-json-webpubsub-subprotocol
  baseURL: wss://{instance}.webpubsub.azure.com
  tags:
  - AsyncAPI
  - CloudEvents
  - Event-Driven
  - Pub-Sub
  - WebSockets
  properties:
  - type: AsyncAPI
    url: https://raw.githubusercontent.com/api-evangelist/microsoft-azure-web-pubsub/main/asyncapi/microsoft-azure-web-pubsub-asyncapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/reference-json-webpubsub-subprotocol
  - type: Reference
    url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/reference-json-reliable-webpubsub-subprotocol
  - type: Reference
    url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/reference-cloud-events
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-generate-client-tokens
- name: Azure Web PubSub Hubs REST API
  description: REST API for managing hub configurations within a Web PubSub instance. Hubs provide logical isolation for messaging
    and allow per-hub configuration of event handlers, anonymous connect policies, and authorization settings.
  image: https://azure.microsoft.com/svghandler/web-pubsub/
  humanURL: https://learn.microsoft.com/en-us/rest/api/webpubsub/web-pub-sub-hubs
  baseURL: https://management.azure.com
  tags:
  - Hubs
  - Resource Manager
  - Web PubSub
  properties:
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/web-pub-sub-hubs
  - type: Reference
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/web-pub-sub-hubs?view=rest-webpubsub-2024-03-01
- name: Azure Web PubSub for Socket.IO REST API
  description: REST API for managing Azure Web PubSub for Socket.IO instances. Provides a fully managed Socket.IO server replacement
    that allows existing Socket.IO applications to scale to millions of connections without rewriting application code.
  image: https://azure.microsoft.com/svghandler/web-pubsub/
  humanURL: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-overview
  baseURL: https://management.azure.com
  tags:
  - Resource Manager
  - Socket.IO
  - Web PubSub
  properties:
  - type: Documentation
    url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-overview
  - type: Reference
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/web-pub-sub?view=rest-webpubsub-2024-03-01
  - type: GettingStarted
    url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/socketio-quickstart
- name: Azure Web PubSub Private Endpoint Connections REST API
  description: REST API for managing private endpoint connections to a Web PubSub service instance. Enables secure, private
    connectivity from virtual networks to Web PubSub through Azure Private Link without exposing traffic to the public internet.
  image: https://azure.microsoft.com/svghandler/web-pubsub/
  humanURL: https://learn.microsoft.com/en-us/rest/api/webpubsub/web-pub-sub-private-endpoint-connections
  baseURL: https://management.azure.com
  tags:
  - Networking
  - Private Endpoints
  - Resource Manager
  properties:
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/web-pub-sub-private-endpoint-connections
  - type: Reference
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/web-pub-sub-private-endpoint-connections?view=rest-webpubsub-2024-03-01
- name: Azure Web PubSub Shared Private Link Resources REST API
  description: REST API for managing shared private link resources for a Web PubSub service. Enables outbound private connectivity
    from Web PubSub to other Azure resources such as Key Vault and Storage when configuring upstream event handlers.
  image: https://azure.microsoft.com/svghandler/web-pubsub/
  humanURL: https://learn.microsoft.com/en-us/rest/api/webpubsub/web-pub-sub-shared-private-link-resources
  baseURL: https://management.azure.com
  tags:
  - Networking
  - Private Link
  - Resource Manager
  properties:
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/web-pub-sub-shared-private-link-resources
  - type: Reference
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/web-pub-sub-shared-private-link-resources?view=rest-webpubsub-2024-03-01
- aid: microsoft-azure-web-pubsub:microsoft-azure-web-pubsub-clienttoken-api
  name: Azure Web PubSub ClientToken API
  description: Generate JWT tokens for client connections
  humanURL: https://learn.microsoft.com/en-us/rest/api/webpubsub/dataplane
  baseURL: https://{instance}.webpubsub.azure.com
  tags:
  - ClientToken
  properties:
  - type: OpenAPI
    url: openapi/microsoft-azure-web-pubsub-clienttoken-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/dataplane
  - type: Reference
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/dataplane/web-pub-sub
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-generate-client-tokens
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub
  - type: Reference
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/web-pub-sub
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/active-directory/develop/authentication-scenarios
- aid: microsoft-azure-web-pubsub:microsoft-azure-web-pubsub-hub-api
  name: Azure Web PubSub Hub API
  description: Send messages and manage connections, groups, and users in a hub
  humanURL: https://learn.microsoft.com/en-us/rest/api/webpubsub/dataplane
  baseURL: https://{instance}.webpubsub.azure.com
  tags:
  - Hub
  properties:
  - type: OpenAPI
    url: openapi/microsoft-azure-web-pubsub-hub-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/dataplane
  - type: Reference
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/dataplane/web-pub-sub
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-generate-client-tokens
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub
  - type: Reference
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/web-pub-sub
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/active-directory/develop/authentication-scenarios
- aid: microsoft-azure-web-pubsub:microsoft-azure-web-pubsub-permission-api
  name: Azure Web PubSub Permission API
  description: Permission management for client connections
  humanURL: https://learn.microsoft.com/en-us/rest/api/webpubsub/dataplane
  baseURL: https://{instance}.webpubsub.azure.com
  tags:
  - Permission
  properties:
  - type: OpenAPI
    url: openapi/microsoft-azure-web-pubsub-permission-api-openapi.yml
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/dataplane
  - type: Reference
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/dataplane/web-pub-sub
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-generate-client-tokens
  - type: Documentation
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub
  - type: Reference
    url: https://learn.microsoft.com/en-us/rest/api/webpubsub/web-pub-sub
  - type: Authentication
    url: https://learn.microsoft.com/en-us/azure/active-directory/develop/authentication-scenarios
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/azure-web-pubsub/overview
- type: AgenticAccess
  url: agentic-access/microsoft-azure-web-pubsub-agentic-access.yml
- type: DomainSecurity
  url: security/microsoft-azure-web-pubsub-domain-security.yml
- type: Authentication
  url: authentication/microsoft-azure-web-pubsub-authentication.yml
- type: Arazzo
  url: arazzo/microsoft-azure-web-pubsub-check-then-close-connection-workflow.yml
  name: Azure Web PubSub Check then Close Connection
- type: Arazzo
  url: arazzo/microsoft-azure-web-pubsub-direct-connection-message-workflow.yml
  name: Azure Web PubSub Direct Connection Message
- type: Arazzo
  url: arazzo/microsoft-azure-web-pubsub-grant-permission-and-send-to-user-workflow.yml
  name: Azure Web PubSub Grant Permission then Send to User
- type: Arazzo
  url: arazzo/microsoft-azure-web-pubsub-grant-permission-if-missing-workflow.yml
  name: Azure Web PubSub Grant Permission if Missing
- type: Arazzo
  url: arazzo/microsoft-azure-web-pubsub-group-broadcast-if-active-workflow.yml
  name: Azure Web PubSub Broadcast to Group if Active
- type: Arazzo
  url: arazzo/microsoft-azure-web-pubsub-group-warn-and-teardown-workflow.yml
  name: Azure Web PubSub Warn Group and Tear Down
- type: Arazzo
  url: arazzo/microsoft-azure-web-pubsub-join-group-and-send-workflow.yml
  name: Azure Web PubSub Join Group, Send, then Leave
- type: Arazzo
  url: arazzo/microsoft-azure-web-pubsub-notify-user-if-online-workflow.yml
  name: Azure Web PubSub Notify User if Online
- type: Arazzo
  url: arazzo/microsoft-azure-web-pubsub-provision-client-and-join-group-workflow.yml
  name: Azure Web PubSub Provision Client and Join Group
- type: Arazzo
  url: arazzo/microsoft-azure-web-pubsub-revoke-permission-and-evict-workflow.yml
  name: Azure Web PubSub Revoke Permission and Evict Connection
- type: Arazzo
  url: arazzo/microsoft-azure-web-pubsub-token-then-broadcast-workflow.yml
  name: Azure Web PubSub Generate Token then Broadcast
- type: Arazzo
  url: arazzo/microsoft-azure-web-pubsub-user-onboard-to-group-workflow.yml
  name: Azure Web PubSub Onboard User to Group
- type: Portal
  url: https://portal.azure.com/
- type: Website
  url: https://azure.microsoft.com/en-us/products/web-pubsub
- type: Documentation
  url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/
- type: GettingStarted
  url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/quickstart-serverless
- type: Authentication
  url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/howto-generate-client-tokens
- type: Pricing
  url: https://azure.microsoft.com/en-us/pricing/details/web-pubsub/
- type: ServiceLevelAgreement
  url: https://azure.microsoft.com/en-us/support/legal/sla/web-pubsub/
- type: StatusPage
  url: https://status.azure.com/
- type: Blog
  url: https://devblogs.microsoft.com/azure-sdk/
- type: Support
  url: https://azure.microsoft.com/en-us/support/options/
- type: TermsOfService
  url: https://azure.microsoft.com/en-us/support/legal/
- type: PrivacyPolicy
  url: https://privacy.microsoft.com/en-us/privacystatement
- type: Signup
  url: https://azure.microsoft.com/en-us/free
- type: Login
  url: https://portal.azure.com
- type: SDKs
  url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/reference-server-sdk-js
- type: SDK - JavaScript
  url: https://www.npmjs.com/package/@azure/web-pubsub
- type: SDK - Python
  url: https://pypi.org/project/azure-messaging-webpubsubservice/
- type: SDK - .NET
  url: https://www.nuget.org/packages/Azure.Messaging.WebPubSub
- type: SDK - Java
  url: https://learn.microsoft.com/en-us/java/api/overview/azure/messaging-webpubsub-readme
- type: SDK - Go
  url: https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/messaging/azwebpubsub
- type: CLI Tools
  url: https://learn.microsoft.com/en-us/cli/azure/webpubsub
- type: ChangeLog
  url: https://azure.microsoft.com/en-us/updates/?product=web-pubsub
- type: GitHubOrganization
  url: https://github.com/Azure
- type: GitHub Samples
  url: https://github.com/Azure/azure-webpubsub
- type: StackOverflow
  url: https://stackoverflow.com/questions/tagged/azure-webpubsub
- type: Community
  url: https://learn.microsoft.com/en-us/answers/tags/371/azure-web-pubsub
- type: FAQ
  url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/resource-faq
- type: RateLimits
  url: https://learn.microsoft.com/en-us/azure/azure-web-pubsub/concept-billing-model
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com