Troubleshoot integrations

Diagnose in order

1. Confirm the business, integration, provider account, and active state.
2. Run the available connection test. Record its exact error rather than repeatedly changing unrelated settings.
3. For authentication failures check expiry, key state, scopes, and provider consent. Regenerate or rotate a credential only after identifying all consumers.
4. For event failures compare direction, event name, and payload fields with the configured consumer. Inspect delivery history and workflow conditions.
5. For wrong product data compare external ID, SKU, source, and last sync time.
6. For a successful request with no result inspect downstream runs, tool output, and the provider record.
7. Before retrying, check whether a previous attempt already sent a notification or changed data.

Escalate with useful evidence

Share the time and time zone, integration ID, event or execution ID, sanitized error, expected result, and actual result through support. Remove full API keys, authorization headers, mailbox passwords, and unnecessary customer information.

Expected result

You can identify which stage failed and reproduce it with controlled data. Use channel troubleshooting for inbox and delivery issues.