Troubleshoot Opal tools

The following sections describe common issues with Optimizely Opal tools in Optimizely Commerce Connect and how to resolve them.

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 or 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.
• Contact Optimizely Support for product-specific questions.