Integration Issues

"Connection Failed"

Probable cause: OAuth authorization expired or was revoked.

Fix:

1. Tap Menu → Integrations
2. Tap the affected integration
3. Tap Disconnect
4. Tap the integration again and sign in to reconnect
5. Grant the requested permissions

OAuth tokens can expire over time. Reconnecting generates a fresh token.

"Permission Denied"

Probable cause: The integration's permission level is set to Off, or the specific action requires a higher permission.

Fix:

1. Tap Menu → Integrations
2. Tap the affected integration
3. Check that the permission level is set to Confirm or Full Auto
4. Try your request again

Learn more about permission levels in Understanding Permissions.

Integration Not Responding

Probable cause: The external service may be experiencing an outage, or your token has expired.

Fix:

1. Check if the service is working (try opening it directly)
2. If the service is up, disconnect and reconnect the integration in Cloa
3. If the service is down, wait and try again later

Data Not Syncing

Probable cause: Stale cache or token refresh failure.

Fix:

1. Close and reopen the Cloa app
2. If data is still stale, disconnect and reconnect the integration
3. Verify the integration has the correct permissions on the service side

General Reconnection Steps

For any integration issue, this process resolves most problems:

1. Tap Menu → Integrations
2. Tap the affected integration → Disconnect
3. Wait a few seconds
4. Tap the integration again → sign in and reconnect
5. Test by asking Cloa to use the integration

What's Next

• Review all your integration settings in Understanding Permissions
• For non-integration issues, check Common Issues