Back to runbook library
troubleshooting
Fixing Connector Auth Failures
Restore OAuth-backed connectors such as Gmail, Slack, or Salesforce without losing downstream workflow state.
Estimated time
5 min
Severity
high
Procedure
1
Confirm the failing connector
Check recent run traces and connector audit logs to identify which integration is returning auth failures.
2
Re-authorize in staging first
Validate the refreshed grant against a non-production workflow before applying it to the production connector.
3
Replay one blocked workflow
Use a safe replay or synthetic request to confirm the connector now performs the expected read/write action.