> This page is for Developers.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.emnify.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.emnify.com/_mcp/server.

# API callbacks

> Configure API callback objects for Data Streamer integration with callback URLs and organizational settings.

For the Data Streamer integration, an API callback object should be included in the request body.

The properties of the API callback are as follows:

| Name              | Type               | Description                                                                                                                    |
| :---------------- | :----------------- | :----------------------------------------------------------------------------------------------------------------------------- |
| `id`              | Integer (required) | Numerical ID of the callback, an existing API callback may be reused based on this `id` and other properties are then optional |
| `url`             | String (required)  | Callback URL                                                                                                                   |
| `organisation_id` | String             | Numerical ID of the organization that created the API callback                                                                 |
| `purpose`         | String             | A description of the use of the `api_callback` object                                                                          |

## Example

The following example request body creates a REST API type data stream.

**POST** `https://cdn.emnify.net/api/v1/data_stream`

```json
{
  "stream_historic_data": 0,
  "data_stream_type": {
    "description": "Events",
    "id": 2
  },
  "api_type": {
    "description": "RestAPI",
    "id": 1,
  },
  "api_callback": {
    "organisation_id": "1337",
    "url": "https://my-application-server.com/callback",
    "purpose": "Adding Alerts for failed auth attempts.",
    "id": 196,
  }
}
```