Error codes reference error-codes
Adobe Journey Optimizer uses standardized error codes to help you quickly identify and resolve issues across journeys, campaigns, and message configurations. Understanding these error codes can significantly reduce troubleshooting time and help you maintain optimal campaign performance.
Understanding error code structure error-code-structure
Adobe Journey Optimizer error codes follow a consistent naming pattern that helps identify the component and issue type:
- Service prefix: Indicates which Adobe Journey Optimizer service generated the error (e.g., CJMPTS for Push/Transport Service, CJMRT for Journey Runtime, CJMMAS for Message Authoring Service, CJMCMP for Campaign, CJMTL for Transport Layer, CJMRPS for Reporting/Provisioning Service)
- Error number: Unique identifier for the specific error condition
- HTTP status code: Standard HTTP status code (e.g., 400, 403, 422, 500)
Example: CJMRT-030012-422 indicates a Journey Runtime error (CJMRT) with error number 030012 and HTTP status 422 (Unprocessable Entity).
Where to find error codes find-error-codes
Error codes appear in several locations within Adobe Journey Optimizer:
- Journey execution reports and logs
- Campaign activation screens
- Message validation warnings
- System notifications and alerts
- API responses (when using REST APIs)
When an error occurs, note the complete error code and any accompanying request ID, as these are essential for troubleshooting and support escalation.
Common error codes by service error-codes-by-service
CJMPTS: Push and Transport Service errors cjmpts-errors
These errors occur during push notification delivery and message transport operations.
2. Check provider configurations and quotas
3. Verify push credentials are valid
4. Test with an alternate channel
5. If persistent, contact Adobe Support with request ID
Related documentation: Push configuration
2. Audit sandbox/organization configuration
3. Verify channel configurations are active
4. Re-create channel configuration if necessary
Related documentation: Channel surfaces
2. Verify push credentials are valid
3. Retry the operation
4. If persistent, contact Adobe Support with request ID
Related documentation: Push configuration
2. Check third-party gateway status
3. Retry after a few minutes
4. Review logs for additional context
Related documentation: Push notifications
2. Check all personalization variables are valid
3. Use a test payload to identify the issue
4. Simplify template complexity if needed
Related documentation: Message templates, Personalization syntax
CJMRT: Journey Runtime and API errors cjmrt-errors
These errors occur during journey execution, event processing, and API operations.
2. Check Adobe Status for outages
3. Escalate to Adobe Support with workflow/job/org details
4. Provide logs and network captures if available
Related documentation: Journey troubleshooting
2. Correct reference/parameter
3. Remove advanced configuration and retry
4. Add features back one by one to identify the issue
Related documentation: Journey troubleshooting, Events configuration
2. Refresh authentication token
3. Use a known-valid user/service account
4. Review product profile assignments
Related documentation: Permissions
2. Audit journey configuration and feature flags
3. Update broken references
4. Review recent system updates and migrations
Related documentation: Journey creation
2. Verify referenced objects (audiences, datasets) exist and are active
3. Validate all required fields are present
4. Test with a known-good payload
Related documentation: Journey troubleshooting, Events configuration
2. Verify all referenced resources (messages, audiences, actions) exist
3. Fix or update broken references
4. Rebuild journey configuration if necessary
Related documentation: Journey creation, Custom actions
2. Check for existing resources with same identifier
3. Delete or rename conflicting objects
4. Review naming conventions
Related documentation: Journey creation
2. Ensure templates and content blocks are published
3. Check all dependencies are properly linked
4. Review journey test mode results
Related documentation: Testing journeys, Journey dependencies
2. Verify subdomain delegation is complete
3. Run configuration wizards again
4. Allow time for DNS propagation (up to 72 hours)
Related documentation: Channel surfaces, Subdomain delegation
2. Simplify configuration if using advanced features
3. Escalate to Adobe Support with request ID and exact payload
4. Check for known issues in release notes
Related documentation: Journey troubleshooting
CJMMAS: Message Authoring Service errors cjmmas-errors
These errors occur when creating, editing, or publishing messages, presets, and content.
2. Allow time for sync between AEM and AJO
3. Retry with a known-good asset
4. Verify asset publishing status in AEM
Related documentation: Assets integration
2. Re-add content in incremental steps to identify the issue
3. Check the Adobe Status page
4. Remove unsupported features or markup
Related documentation: Content templates
2. Validate message/preset configuration
3. Check field value formats and constraints
4. Review validation messages in UI
Related documentation: Email channel, Channel surfaces
2. Compare to a known-good configuration
3. Use message UI validation before saving
4. Review field requirements in documentation
Related documentation: Message presets, Email settings
2. Retry the operation
3. Save work incrementally
4. If persistent, escalate to Adobe Support
Related documentation: Content templates
2. Ensure link is present in every language version
3. Use personalization helper to insert opt-out link
4. Test all variants before publishing
Related documentation: Opt-out management, Email design
2. Check preset/template status (draft, published, archived)
3. Request access from administrator if needed
4. Review product profile assignments
Related documentation: Permissions, Access control
CJMCMP: Campaign errors cjmcmp-errors
These errors occur during campaign creation, configuration, and activation.
2. Re-link or re-add message nodes
3. Activate test mode to force creation of inline campaigns
4. Move to the new journey wizard if issue is frequent
Related documentation: Journey creation, Testing journeys
2. Validate schema and data provider connections
3. Reload UI and clear browser cache
4. Recreate node/email if issue unresolved
Related documentation: Content experiments
2. Use the new journey version/template
3. Use test mode to clear configuration
4. Bulk recreate nodes if issue is widespread
Related documentation: Channel surfaces, Message simulation
2. Verify policy/segment links are current and valid
3. Update with correct configuration
4. Re-test campaign before activation
Related documentation: Campaign creation, Campaign approval
CJMTL: Transport Layer errors cjmtl-errors
These errors occur during message transport and delivery operations.
2. Verify the latest AJO version is in use
3. Retry the operation
4. Use static domains if issue persists
Related documentation: Personalization syntax, Email design
2. Fix profile/contact information
3. Validate with test profile
4. Refactor payload format as needed
Related documentation: Profile management, Test profiles
CJMRPS: Reporting and Provisioning Service errors cjmrps-errors
These errors occur during reporting configuration and dataset provisioning operations.
2. Do not re-add datasets already present
3. Use official migration checklists for reporting migration
4. Remove duplicate dataset references
Related documentation: Reporting overview, Campaign reports, Journey reports
General troubleshooting approach troubleshooting-approach
When encountering an error code, follow this systematic approach:
-
Identify the error: Note the complete error code, HTTP status, and any accompanying message or request ID.
-
Find the service: Use the service prefix (CJMPTS, CJMRT, CJMMAS, CJMCMP, CJMTL, CJMRPS) to identify which component is affected.
-
Check the status code:
- 400 (Bad Request): Review input data and configuration
- 403 (Forbidden): Check permissions and access rights
- 409 (Conflict): Look for duplicate or conflicting resources
- 422 (Unprocessable Entity): Validate data against schema requirements
- 500 (Internal Server Error): Retry and potentially escalate to support
-
Review recent changes: Consider what was modified recently (journey updates, new campaigns, configuration changes, etc.).
-
Consult documentation: Use the links provided in this guide to access detailed documentation for the affected feature.
-
Retry when appropriate: For 500-series errors, a simple retry after a few minutes often resolves transient issues.
-
Escalate when needed: If the error persists after following resolution steps, contact Adobe Support with:
- Complete error code
- Request ID (if available)
- Steps to reproduce
- Relevant configuration details
Best practices to avoid common errors best-practices
Before journey activation journey-best-practices
- Validate all resources: Ensure all referenced audiences, events, data sources, and custom actions are properly configured
- Test thoroughly: Use test mode to identify issues before publishing (Learn more)
- Validate volumes: Use dry run to validate audience reach and branch logic before going live (Learn more)
- Check permissions: Verify you have necessary access rights for all components
- Review dependencies: Ensure all linked messages and content are published
When creating messages message-best-practices
- Complete required fields: Always fill in all mandatory fields before saving
- Include opt-out links: Add unsubscribe links to all email variants (Learn more)
- Validate personalization: Test all dynamic content with sample profiles (Learn more)
- Keep templates manageable: Avoid overly complex templates that may cause rendering issues
For campaign management campaign-best-practices
- Verify audience data: Ensure target audiences are properly configured and populated
- Check approval status: Understand approval requirements before attempting to activate (Learn more)
- Monitor configurations: Regularly review channel surfaces and presets for validity
- Plan DNS changes: Allow sufficient time for DNS propagation when updating domains
Additional resources additional-resources
Getting support getting-support
If you encounter persistent errors that cannot be resolved using this guide:
- Gather information: Collect the error code, request ID, timestamps, and steps to reproduce
- Check system status: Visit Adobe Status for known service issues
- Search documentation: Review Adobe Experience League for solutions
- Engage community: Post questions in the Adobe Journey Optimizer Community
- Contact Adobe Support: Submit a support ticket with all relevant details
Related topics