Developer documentation

Authentication

Every request to the ContioReach Content API requires an API key.

ContioReach supports two authentication methods.

X API Key header

Recommended for new integrations:

Header

X-API-Key: YOUR_API_KEY

JavaScript

fetch

const response = await fetch(
  process.env.CMS_API_URL + "/post",
  {
    headers: {
      "X-API-Key": process.env.CMS_API_KEY
    }
  }
);

cURL

curl

curl -X GET "https://contioreach.com/api/public/post" \
  -H "X-API-Key: your_api_key_here"

Authorization header

You can also pass your API key as a Bearer token:

Header

Authorization: Bearer YOUR_API_KEY

Example:

fetch

const response = await fetch(
  process.env.CMS_API_URL + "/post",
  {
    headers: {
      Authorization:
        `Bearer ${process.env.CMS_API_KEY}`
    }
  }
);

For consistency, we recommend using X-API-Key for new integrations.

Authentication failure

Invalid or missing credentials return:

Status

401 Unauthorized

Response:

JSON

{
  "error": "Authentication error message"
}

If you receive a 401 response, check:

The API key is present
The API key is correct
The authentication header is correct
The application is using the expected workspace API key

PreviousEnvironment Setup NextPosts