Creating an API Integration Project
In order to make API calls to the Cloud Manager API, you must create a project (formerly known as an integration) in the Adobe Developer Console. This project defines the credentials used when making API calls as well as the permissions associated with those credentials.
To work with the Cloud Manager API on the Adobe Developer Console, you need to either the System Administrator role or be an assigned API Developer for your organization. Click here to learn more about the API Developer role.
Note that the API Developer role required to create integrations in the Adobe Developer Console is unrelated to the Developer role within Cloud Manager (i.e. the "Developer - Cloud Manager" or "Developer - Cloud Service" product profile). The former is assigned to a user who is permitted to create integrations in the Adobe Developer Console. The latter is assigned to a user who has development rights within Cloud Manager itself. Granting one of these does not grant the other.
When you receive notification of this role, click the Get Started button in the message to access services.
All requests to the Cloud Manager API must be authenticated using an access token. The Adobe I/O OAuth Documentation provides a guide to generate your first access token with the OAuth Server-to-Server credential.
To authenticate Cloud Manager APIs using a JWT access token, refer to the Adobe I/O JWT Documentation for a guide on creating the certificate files required to set up the integration and instructions on generating your first access token.
To create an API Integration:
Navigate to the following URL: https://developer.adobe.com/console. This can also be reached by clicking the Console button at the top of this page.
Click the
Create new projectbutton or select an existing project.(Optional) Click the
Edit projectbutton and give your project a title and description.Click the
Add to Projectbutton and selectAPIfrom the drop-down menu.Under the Experience Cloud section select
Cloud Managerand then clickNext.Select
OAuth Server-to-Serverauthentication. Note that obtaining JWT access token through Generate or Upload a key pair is deprecated.
- Select one of the Product Profiles to assign the integration to a specific Cloud Manager role.
If you are an API Developer in the organization, you may be restricted as to which Product Profiles you can select here.
- Click
Save configured API.
Your client is now created. Notice your client has an Client ID (sometimes referred to as an API Key) and an Organization ID. You'll need these when making API calls. You will also need the Client Secret and Scopes values to obtain an Access Token.
