Troubleshoot

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.