Follow

Getting Started with the Content Controller API - Authentication

Avatar

When using the CC API, you will first need to generate API credentials through the application's web app with the following steps (see screenshot 1_create_credentials.png):

  • Sign in to Content Controller as an admin user
  • Go to Settings -> Administration
  • Select the Integrations tab
  • Click Add
  • Enter a name for the application and select a scope for your credentials
  • Save the Key and Secret that appear

Screenshot 2024-09-06 at 1.38.38 PM.png


Then you can use the key and secret you've saved in a request to the API to generate a short-lived bearer token. The key and secret should be provided via basic auth. The response will send back a JSON object. Save the "access_token" property, as this is the bearer token you will use for subsequent requests (see screenshots 2_auth_headers.png and 2_request_body.png).

 

screenshots_2_auth_headers.png

2_request_body.png

 

You will also want to check your headers to make sure that you are using `application/x-www-form-urlencoded` as the Content-Type header.  If you aren't using that Content-Type, you may run into HTTP 415 Unsupported Media Type Errors.  

 

PostmanHeaders.png

 

Once you have the bearer token, you can use it to make calls to the other endpoints in the API. Just set the auth type in Postman to "Bearer Token", then paste the token you saved from the last request as the value of the token (see screenshot 3_auth_headers.png).

 

screenshot_3_auth_headers.png

 

 

 

Let us know if this inspires questions!  Feel free to reach out to us at support@rusticisoftware.com

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request
Powered by Zendesk