Send event

Article
06/25/2024

Sends a new event to an event hub.

Request

Method	Request URI
POST	`https://{eventHubsNamespace}.servicebus.windows.net/{eventHubPath}/messages`

Request Headers

See Common parameters and headers for headers and parameters that are used by all requests related to Event Hubs.

Request Body

The body of the event message in plain text. For example:

{ “Location”: “Redmond”, "Temperature":"37.0" }

Response

The response includes an HTTP status code, a set of response headers, and a response body.

Response Codes

Code	Description
201	Success.
401	Authorization failure.
500	Internal error.

Response Body

If the request is successful, the response body is empty. If the request isn't successful, the body contains an error code and error message.

Examples

The following HTTP request sends an event with no UserProperties:

Note

You can also use an Azure Active Directory token for the Authorization header as noted in the Common parameters and headers. For example: Authorization: Bearer <Azure AD token>.

POST https://your-event-hubs-namespace.servicebus.windows.net/your-event-hub/messages?timeout=60&api-version=2014-01 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-event-hubs-namespace.servicebus.windows.net&sig=your-sas-key&se=1403736877&skn=RootManageSharedAccessKey  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Host: your-event-hubs-namespace.servicebus.windows.net  
  
{ "DeviceId":"dev-01", "Temperature":"37.0" }

The following example is a request with UserProperties:

POST https://your-event-hubs-namespace.servicebus.windows.net/your-event-hub/messages?timeout=60&api-version=2014-01 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-event-hubs-namespace.servicebus.windows.net&sig=tYu8qdH563Pc96Lky0SFs5PhbGnljF7mLYQwCZmk9M0%3d&se=1403736877&skn=RootManageSharedAccessKey  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Host: your-event-hubs-namespace.servicebus.windows.net  
Alert: Strong Wind  
  
{ "DeviceId":"dev-01", "Temperature":"37.0" }

Event Hubs returns the following response:

HTTP/1.1 201 Created  
Content-Type: application/xml; charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 23 Feb 2016 03:22:27 GMT  
Content-Length: 0

Share via