Integration API quickstart

Response status codes

3min
the api can respond with any of the following response codes unhandled content type 2xx – the response was successful unhandled content type 400 bad request – something was wrong with your request we don't have further details — but we do recommend checking your syntax and parameters of your request, and that the queried organization id and event id exist unhandled content type 403 forbidden – you didn't provide a valid api access token, or the owner of the api key have "organization administrator" (org admin) privileges within your event's organization on brella unhandled content type 404 not found – you are trying to access a resource that doesn't exist this error can also occur if there are issues with the request url for example, assume that you are trying to get /api/integration/organizations/1/events/123 while an event with id 123 does exist, it belongs to organization 2 as such, the api would return a response of 404, as it is searching for event 123 in organization 1 — which is an entity that does not exist unhandled content type 422 unprocessable entity – you are trying to create or update a resource with invalid data we recommend checking your syntax and parameters of your request, and that the queried organization id and event id exist unhandled content type 5xx internal server error – our code crashed sorry about that our error tracking system probably caught this, and we will look into it soon however, if you are in a hurry, please reach out to your brella contact person (most likely your customer success manager or key account manager) to request a quick fix you can also leave us a message via our technical support team