# Send Custom Events to Bonomi

## Authentication

The Bonomi Event API uses API token authentication. For each of our partners we provide a unique API Token, that should not be shared with anyone. To authenticate with the token, add `Authorization: Bearer API_TOKEN` to the header of your calls. 

## Endpoints

Currently we provide one webhook endpoint for your calls with reservation-related events but we're adding more event types and endpoints over the course of 2022. 

See the detailed reference for setting up your call to our Reservation endpoint.

{% content-ref url="/pages/bmZCLeuZsjdYKKl1AQTt" %}
[Reservation](/bonomi-event-api/reference/reservation.md)
{% endcontent-ref %}

## Responses

The Bonomi Event API uses conventional HTTP response codes to indicate success or failure of your request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error resulted from the provided information, and codes in the 5xx range indicate an error with Bonomi's servers.\
 \
Common errors include:\
– `400 Bad Request` This usually happens when the data sent with the call doesn't match the expected format.\
– `401 Unauthorized` This happens when the authentication isn't correct. Either the API Token is wrong, the user token doesn't exist\
– `404 Not found` This usually happens when the endpoint doesn't exist


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bonomi.io/bonomi-event-api/send-custom-events-to-bonomi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.