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)
- 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. 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. 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 versions
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. 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. 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
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) 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