Skip to Content
IntegrationsConnecting Services

Connecting Services

Connect integrations using OAuth (for most services) or API keys (for some). Decoder stores tokens securely and refreshes them automatically when needed.

Connecting (OAuth)

  1. Go to Integrations
  2. Find the integration you want (e.g., Slack, Gmail, HubSpot)
  3. Click Connect (or click the card body)
  4. A new browser window or tab opens with the provider’s login page
  5. Sign in with your account (Google, Microsoft, Slack, etc.)
  6. Review and approve the permissions Decoder requests
  7. You’re redirected back to the Integrations page
  8. The card shows Connected and Connected as: [Account Name]

Note: Your provider account email may need to match an existing Decoder user for some integrations.

Connecting (API Key)

For integrations like Avoma and Fireflies:

  1. Go to Integrations
  2. Find the integration and click Configure or Manage
  3. Enter your API key (from the provider’s account settings)
  4. Enable the integration checkbox
  5. Click Update

Re-authentication

Tokens can expire or stop working. If an integration fails (e.g., API errors in automations):

  1. Go to Integrations
  2. Find the integration
  3. Click Reconnect (OAuth) or Configure (API key)
  4. Complete the OAuth flow again or re-enter the API key
  5. The integration should work again

When to reconnect: Token expiry, permissions revoked, or you want to switch to a different account.

Disconnecting

  1. Go to Integrations
  2. Find the connected integration
  3. Click Disconnect
  4. Confirm if prompted

Effect: Tokens are removed. Automations and Assistants using this integration will fail until you reconnect.

Troubleshooting

OAuth Flow Fails or Redirects to Error

  • Pop-up blocked – Allow pop-ups for the Decoder domain
  • User denied – Try again and approve permissions
  • Invalid redirect – Check provider configuration; contact support if needed

Integration Shows Connected but API Calls Fail

  • Token expired – Click Reconnect
  • Permissions revoked – Check provider account settings and reconnect
  • Rate limits – Wait and retry; some providers have usage limits

Status Indicator Stuck on Loading

  • Wait a few seconds
  • Refresh the page
  • Check browser console for errors

Account Name Not Showing

  • Account info loads asynchronously
  • Refresh the page
  • Some integrations may not display account names
Last updated on
OverviewIntegration Reference