Troubleshoot
4 min
The following are ways to resolve issues you may see while using Optimizely Opal tools with Optimizely Commerce Connect.
"Authorization failed" (401)
- Ensure your Opti ID token is valid and not expired.
- Check that the token includes the required scopes.
- Verify the authorization header format: Bearer <token>.
"Campaign/Promotion not found" (404)
- Verify the identifier is correct (name or ContentReference ID).
- Use campaign_filter or promotion_filter to search for the correct resource.
"Content Graph query failed"
- Verify the Content Graph configuration in appsettings.json.
- Check that GatewayAddress, AppKey, and Secret are correct.
- Use com_graph_schema to verify the schema structure.
"Property path not found" in dynamic update
- Use promotion_properties to get valid property paths.
- Verify that property paths use underscore notation (such as Condition_RequiredQuantity).
- Ensure the property exists on the specific promotion type.
"ValidUntil must be greater than ValidFrom"
- Verify the campaign end date is after the start date.
- Check the date format (ISO 8601).
Get help
For additional assistance, see the following:
- Check the GitHub repository.
- Review the CLAUDE.md file for implementation details.
- Contact Optimizely Support for product-specific questions.