Azure Notification Hubs

Azure Notification Hubs REST API

Azure Notification Hubs REST API enables sending push notifications at scale to iOS, Android, Windows, and other platforms. It supports device registration, tag-based routing, template notifications, scheduled sends, and telemetry for tracking delivery metrics.

Documentation GitHub OpenAPI

Documentation

📖

Documentation

https://learn.microsoft.com/en-us/rest/api/notificationhubs/

📖

Authentication

https://learn.microsoft.com/en-us/rest/api/notificationhubs/authentication

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/microsoft-azure-notification-hubs/refs/heads/main/openapi/microsoft-azure-notification-hubs-openapi.yml

OpenAPI Specification

openapi: 3.1.0
info:
  title: Azure Notification Hubs REST API
  description: Azure Notification Hubs REST API enables push notification delivery to Apple, Google, Windows,
    and Amazon devices. Operations include sending notifications, managing registrations, and installations.
  version: 2020-06
externalDocs:
  description: Azure Notification Hubs REST API Documentation
  url: https://learn.microsoft.com/en-us/rest/api/notificationhubs/
servers:
- url: https://{namespace}.servicebus.windows.net
  variables:
    namespace:
      default: mynamespace
tags:
- name: Notifications
- name: Registrations
- name: Installations
security:
- sasToken: []
paths:
  /{hub}/messages:
    parameters:
    - name: hub
      in: path
      required: true
      schema:
        type: string
    post:
      operationId: sendNotification
      summary: NH Send notification
      description: Sends a push notification to all registrations or via tag expression.
      tags:
      - Notifications
      parameters:
      - name: ServiceBusNotification-Format
        in: header
        required: true
        schema:
          type: string
      - name: ServiceBusNotification-Tags
        in: header
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '201':
          description: Notification queued
  /{hub}/registrations:
    parameters:
    - name: hub
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: listRegistrations
      summary: NH List registrations
      description: Lists registrations.
      tags:
      - Registrations
      responses:
        '200':
          description: Registrations
          content:
            application/atom+xml:
              schema:
                type: object
    post:
      operationId: createRegistration
      summary: NH Create registration
      description: Creates a new registration.
      tags:
      - Registrations
      requestBody:
        required: true
        content:
          application/atom+xml:
            schema:
              type: object
      responses:
        '201':
          description: Registration created
  /{hub}/installations/{id}:
    parameters:
    - name: hub
      in: path
      required: true
      schema:
        type: string
    - name: id
      in: path
      required: true
      schema:
        type: string
    put:
      operationId: createOrUpdateInstallation
      summary: NH Upsert installation
      description: Creates or updates an installation.
      tags:
      - Installations
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '200':
          description: Installation updated
    delete:
      operationId: deleteInstallation
      summary: NH Delete installation
      description: Deletes an installation.
      tags:
      - Installations
      responses:
        '204':
          description: Deleted
components:
  securitySchemes:
    sasToken:
      type: apiKey
      in: header
      name: Authorization
x-generated-from: https://learn.microsoft.com/en-us/rest/api/notificationhubs/
x-generated-by: claude-crawl-2026-05-08