Skip to content


Blooma uses conventional HTTP response codes to indicate the success or failure of an API request. In general the following applies:

  • Codes in the 200 - 299 range indicate a successful request.
  • Codes in the 400 - 499 range indicate the request failed given the information provided (e.g., a required parameter was omitted, the requested entity doesn't exist, etc.).
  • While rare, codes in the 500 - 599 range indicate an error with Blooma's services, if encountered please notify your CX manager.

401 Unauthorized

Your request is not authenticated.


Ensure that you have followed the authentication instructions and provided a valid Authorization header.

403 Forbidden

You're not allowed to access this endpoint with your current credentials' permissions.


If you believe this to be in error, reach out to your Blooma CX Manager to verify that your Client credentials have the correct permissions assigned.

404 Not Found

The requested entity or resource does not exist.


Verify that the item you are trying to reference exists and that all ids are valid.

Last update: 2023-07-14