Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Sends a notification to a template registration on a notification hub.
Request
| Method | Request URI | HTTP Version |
|---|---|---|
| POST | https://{namespace}.servicebus.windows.net/{NotificationHub}/messages/?api-version=2015-01 |
HTTP/1.1 |
Request headers
The following table describes required and optional request headers.
| Request header | Description |
|---|---|
| Authorization | SAS token generated as specified in Shared Access Signature Authentication with Service Bus. |
| Content-Type | Set to application/json;charset=utf-8. |
| ServiceBusNotification-Tags | {single tag identifier} (optional) |
| ServiceBusNotification-Format | Set to template (optional) |
Request body
The request body is a JSON object, with only string properties. For example:
{
"message": "My message!",
"otherPropety": "my other value"
}
Response
The response includes an HTTP status code and a set of response headers.
Response codes
| Code | Description |
|---|---|
| 200 | Message successfully sent. |
| 400 | The request is malformed (for example, not valid routing headers, not valid content-type, message exceeds size, bad message format). |
| 401 | Authorization failure. The access key was incorrect. |
| 403 | Quota exceeded or message too large; message was rejected. |
| 404 | No message branch at the URI. |
| 413 | Requested entity too large. The message size cannot be over 64 Kb. |
For information about status codes, see Status and Error Codes.
Response headers
| Response header | Description |
|---|---|
| Location | This header is only available for Standard tier Notification Hubs. This header will contain the Notification Message ID. It's used with Per Message Telemetryand correlating PNS Feedback. The ___location header uses the following format: https://{your namespace}.servicebus.windows.net/{your hub name}/messages/{notification message id}?api-version=2015-04 |
Response body
None.