Fix Integration Failures
If your integrations (Meta CAPI, sGTM, GA4, etc.) are showing errors or not forwarding events, follow these steps to diagnose and fix the issue.
Common Issues
- Invalid credentials — API keys or access tokens may have expired or been revoked
- Platform API outage — The destination platform may be experiencing issues
- Rate limiting — You may be exceeding the platform's API rate limits
- Circuit breaker open — Arqam360's circuit breaker may have tripped due to repeated failures
- Network issues — Server-to-server connectivity problems
Circuit Breaker
When an integration fails 5 times consecutively, the circuit breaker trips and stops sending events to that platform for 60 seconds. This prevents cascading failures and wasted API calls. The circuit breaker resets automatically after the timeout.
Retry Behavior
Failed events are automatically retried with exponential backoff. The retry queue is processed by the event pipeline worker. You can see failed events in the Decision Log.
Check integration status
Go to Integrations tab and check if the integration shows a red status or error count.
Test the connection
Click 'Test Connection' to verify Arqam360 can reach the platform.
Check credentials
Verify your API keys and tokens are still valid in the platform's admin.
Check the Decision Log
Go to the Decision Log tab to see recent forwarding decisions and any errors.
Re-enable if needed
If the integration was auto-disabled (10 failures), fix the issue and re-enable it.
Was this article helpful?