> 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.smartsim.telecom.li/llms.txt.

# 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://smartsim.telecom.li/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,
  }
}
```