[Admins only] Get Credentials

data-variant=warning

data-slots=text

This page contains instructions for these admins to create project keys for their teams. If you are a developer and your admin has shared a valid key with you, head over to the quickstart guide

Access Adobe Developer Console

Navigate to the API and services section. Search for Adobe Firefly API.

API and services page - Firefly API card

Can't find the Adobe Firefly API ? No worries, give it a few minutes and try again. Reach out to your Adobe liaison if you cannot see the Firefly API product card.

Create a new project

Once you can see the Firefly API product card, click the Create project button.

Let's start by registering your project name. This will help you find your project in the Developer Console later. You will be able to modify this name later.
Click on Save configured API in the following modal. On the next screen, you will be able to see your client ID (API key).
From the left navigation, select OAuth Server-to-Server and you can click Retrieve client secret to get your client secret.

OAuth Server-to-Server credential page

To make calls to the Firefly API, developer(s) need a valid client ID (API key) and an access token. Since organization admins are the only ones who can access these projects in the Console, using the Generate access token button on the credential overview page is not ideal.

data-variant=warning

data-slots=text

Instead of sharing access tokens, we recommend sharing the client ID and client secret with developers who need access to the API. This way, they can programmatically generate new access tokens as each access token expires after 24 hours.

After you have successfully configured your project in Developer Console:

In the Generate access tokens block, select View cURL command.
Copy the command and share with developers in your org. It should look similar to the following:

curl -X POST 'https://ims-na1.adobelogin.com/ims/token/v3' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'grant_type=client_credentials&client_id={client_id}&client_secret={client_secret}&scope=openid,AdobeID,session,additional_info,read_organizations,firefly_api,ff_apis'

Read more about generating access tokens in the authentication guide. There, you can also find the steps for rotating your client secret programmatically.