What You Can Do
Campaigns & Journeys
Inspect AJO campaigns and journeys. View messages, templates, and fragments. Create or update supported objects when APIs and permissions allow.
Content & Templates
Read templates and fragments so Gradial can reference them when drafting new messages. Generate content drafts aligned to your existing AJO assets.
Insight to Action
Pull AJO tracking datasets and performance context. Turn campaign results into recommendations, content updates, or next-journey plans.
Cross-Platform Execution
Use AJO context to execute or draft work in SFMC, Marketo, AEM, SMS, push, CMS, or another connected marketing system.
Prerequisites
Before starting setup, confirm the following are in place:- An active Adobe Experience Cloud organization with AJO licensed and live
- Access to the Adobe Developer Console to create a project and generate server-to-server OAuth credentials
- The IMS Org ID for your Adobe Experience Cloud organization
- The sandbox name (or environment) where Gradial should start — sandbox, staging, or production read-only
- Product profile membership that covers the AJO APIs in scope
- A Gradial organization Administrator role to complete setup
How to Connect
Create an Adobe Developer project
- Go to Adobe Developer Console and sign in with your Adobe ID.
- Select your organization from the org switcher.
- Click Create new project.
- Give the project a name (e.g.,
Gradial – AJO Integration).
Add the Adobe Journey Optimizer API
- Inside your new project, click Add API.
- Filter by Experience Cloud and select Adobe Journey Optimizer.
- Choose OAuth Server-to-Server as the authentication type and click Next.
- Select or create a Product Profile that grants the API scopes needed:
| Scope | Required | Purpose |
|---|---|---|
ajo.campaigns.read | Yes | Read campaigns |
ajo.journeys.read | Yes | Read journeys |
ajo.messages.read | Yes | Read messages and channel content |
ajo.templates.read | Yes | Read templates and fragments |
ajo.campaigns.write | Optional | Create or update campaigns |
ajo.journeys.write | Optional | Create or update journeys |
- Click Save configured API.
Copy your credentials
From the project’s OAuth Server-to-Server credential page, copy:
- Client ID
- Client Secret
- IMS Org ID
- Technical Account ID
- Sandbox name (the AJO sandbox you authorized)
Add the integration in Gradial
- In Gradial, go to Settings → Integrations.
- Find Adobe Journey Optimizer and click + Add.
- Fill in the connection details:
| Field | Value |
|---|---|
| Integration Name | A display name (e.g., Acme – AJO Production) |
| IMS Org ID | From step 3 |
| Client ID | From step 3 |
| Client Secret | From step 3 |
| Technical Account ID | From step 3 |
| Sandbox Name | The AJO sandbox Gradial should connect to |
- Click Save. Gradial validates the credentials before the integration goes live.
How It Fits Into Broader Workflows
| Use case | How to use it |
|---|---|
| Campaign support | Ask Gradial to inspect an AJO campaign, summarize its current state, and draft an updated message or subject line |
| Journey planning | Use Gradial to map an existing journey’s structure, identify gaps, and draft the next phase |
| Insight to content | Pull AJO tracking data into a Gradial thread and have it generate a performance summary and follow-up content plan |
| Cross-platform execution | Use AJO audience and campaign context to execute or draft work in SFMC, Marketo, AEM, SMS, push, or CMS |
| Migration acceleration | Inventory source journeys and assets, classify what can be automated, and generate build packets for the destination system |
- Ask Gradial to list active AJO campaigns.
- Select a campaign and have Gradial summarize its messages and performance.
- Ask Gradial to draft an updated subject line and body copy.
- Review the draft and publish through AJO when ready.
- Share an AJO audience or journey with Gradial.
- Ask Gradial to draft a matching email in Salesforce Marketing Cloud or Marketo.
- Gradial reads the AJO context, creates the asset in the connected system, and returns a link for review.
What’s Not Covered Yet
- Direct send or trigger execution for live journeys — Gradial can draft and inspect, but send execution depends on API availability and your governance policy.
- Authoring new message surfaces or channel configurations — these are managed in the AJO UI.
- Private or beta AJO APIs — Gradial uses publicly available REST APIs only.
- Adobe Analytics or AEP audience context without a separate AEP integration configured.
Customer Information Needed Before Setup
Use this checklist to confirm readiness before the integration meeting:- Adobe IMS Org ID, sandbox name, and environment confirmation (sandbox, staging, or production read-only)
- Adobe Developer Console project with OAuth Server-to-Server credentials and required product profiles
- AJO context objects Gradial should read: campaigns, journeys, messages, templates, fragments, tracking datasets
- Active channels in scope: email, push, SMS, in-app, web
- Sender domains, consent policy, and suppression list configuration (required for any write operations)
- Adjacent execution systems if cross-platform activation is in scope: SFMC, Marketo, AEM, CMS, or another destination
- Governance model: who approves drafts, who can publish, who can send, and whether Gradial should start read-only
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
401 Unauthorized | Invalid or expired credentials | Regenerate the Client Secret in Adobe Developer Console and update Gradial |
403 Forbidden | Missing API scopes | Add the required scopes to the product profile in Adobe Developer Console |
404 Not Found | Incorrect sandbox name | Verify the sandbox name matches your AJO environment exactly |
| Token refresh failures | Client Secret rotated | Update the Client Secret in Gradial Settings → Integrations |
Good to Know
- Start read-only: Gradial can deliver immediate value — inspecting campaigns, summarizing journeys, drafting content — without write permissions. Enable write scopes only when governance is confirmed.
- Sandbox first: Validate the integration in an AJO sandbox before pointing Gradial at a production environment.
- Governance is explicit: Read, draft, write, publish, and send permissions can be scoped separately so each team controls its own activation path.