Requests to Kosmo API must be authenticated otherwise they will fail with Unauthorized 401 error response.

Obtain API Key


Getting your key

To get started, request an api key by sending an email to [email protected] along with your business phone number you want or have attached to your account

The api_key will be used to bypass authentication to Kosmo API.


To authenticate your requests, you must add the Authorization header with Bearer + your API key as the value.



Your secret key is extremely sensitive, be sure to safely store it and to never share it with anyone outside your tech team.
If you acknowledge a breach, contact us immediately to deprecate your former key and get a new one.

Here is an example of a request to test your key:

curl --location --request GET '' \
--header 'Authorization: Bearer {api_key}'

The response should contain your organization team information.