Information for: DEVELOPERS   PARTNERS

Cloud API v2 authentication

All Acquia Cloud API calls require authentication to work properly. The information on this page is applicable only for Cloud API version 2.

For information about authenticating with Cloud API version 1 (v1), which will reach end-of-life on April 15, 2020, see Cloud API v1 authentication.

Generating an API token

To generate an API token for authenticating with the Acquia Cloud API, complete the following steps:

  1. Sign in to Acquia Cloud using your email address and Acquia password.

  2. Click your user avatar in the upper right corner, and then click Account Settings.

    Edit your profile

  3. On the Profile page, click API Tokens.

  4. Provide a human-readable label for your API token, and click Create Token.

    Acquia Cloud will generate an API Key and API secret for you.

  5. Record a copy of your API Key and API secret, as you cannot retrieve them after closing your browser tab.

You can remove a token at any time by clicking Remove next to the token you want to remove.

Authenticating in Cloud API RESTful interface calls

Each Cloud API call authenticates requests with OAuth 2.0 client credentials, and requires the information provided when generating an API token.

The Client ID and Secret are exchanged for a bearer access token, which authenticates calls to the Acquia Cloud API.

Authenticating from a browser

Acquia Cloud API also implements Cross-origin resource sharing (CORS), enabling you to implement authentication in browser-based clients when using Acquia’s supported API tokens. Requests should use the Access-Control-Allow-Origin header for identification.