Set Up Instructions

Adobe

The Adobe integration connects Ploy to your Adobe Admin Console organization through Adobe's User Management API, using an OAuth Server-to-Server credential.

The Adobe integration is currently setup-only. You can connect Adobe and test the connection now, but Ploy is not yet scanning Adobe users. User ingestion will be enabled in a follow-up release — connecting now will not import any data.

The Adobe User Management API is only available on Adobe ENTERPRISE organizations. It is NOT available on free, Individual, Teams, or Education plans. You must also be a System Administrator of that Adobe organization to create the credential — the option is unavailable to other roles.

If you reach Create an Adobe OAuth Server-to-Server credential step 4 (Add API) and User Management API does not appear in the list, it means your Adobe account/organization does not meet these requirements (most commonly because it is a free or non-Enterprise account). There is no workaround on a non-Enterprise plan — you will need access to an Adobe Enterprise organization with System Administrator rights.

Before you begin

  • You need System Administrator access to your Adobe organization to create credentials in the Adobe Developer Console.

  • Your credential must include the User Management API with the user_management_sdk scope. The scope is included automatically when you add the User Management API to your Developer Console project.

Create an Adobe OAuth Server-to-Server credential

  1. Go to the Adobe Developer Console and sign in with your Adobe ID.

  2. Select Create new project (or open an existing project you want to use for Ploy).

  3. Click Add API.

  4. Select User Management API and click Next.

  5. Choose the OAuth Server-to-Server credential type, give the credential a recognisable name (for example Ploy), and save it.

  6. Open the credential's overview page and copy the Client ID.

  7. Click Retrieve client secret and copy the Client Secret.

  8. Note your Organization ID — it is shown on the Developer Console project overview and looks like ABC123@AdobeOrg.

For more detail on this credential type, see Adobe's Server-to-Server authentication guide.

Connect Adobe in Ploy

  1. In Ploy, navigate to Integrations and select Adobe.

  2. In Organization ID, paste your Adobe Admin Console organization ID (for example ABC123@AdobeOrg).

  3. In Client ID (API Key), paste the Client ID from your OAuth Server-to-Server credential.

  4. In Client Secret, paste the Client Secret from your OAuth Server-to-Server credential.

  5. Continue to the next page and click Test Connection to verify Ploy can connect to your Adobe organization.

Troubleshooting

Failed to authenticate with Adobe

Check your Organization ID, Client ID, and Client Secret. Make sure the Organization ID includes the @AdobeOrg suffix and that the credential's project includes the User Management API.

Connection test fails with correct credentials

Confirm the credential is an OAuth Server-to-Server credential (not a deprecated Service Account/JWT credential) and that it includes the user_management_sdk scope.

Rotated client secret

If you rotate the client secret in the Adobe Developer Console, update the Client Secret in Ploy's Adobe integration settings and re-run the connection test.

Was this helpful?
Was this helpful?