Composio
OAuth Provider Catalog

Integration & Setup Guides

Friction scores, unwritten failure modes, least-privilege scope mappings, and 1-click Composio AuthConfigs.

Category:
GitHub

GitHub

Developer Tools

1.0/5
Friction: 1.0 / 5
Instant
Instant / Low Friction (1.0 - 1.9)

Zero review hurdles. Self-serve credentials and test tokens generated instantly in developer portal.

Review Gate:None
Approval Wait:0 days (Instant)
Setup Effort:~8 mins
Compliance Cost:$0 (Free)
PKCE Protocol:Optional
Scale: 1.0 (Low) → 5.0 (High)Click card to view

Instant 0-day approval. GitHub OAuth apps require no central manual review to serve external users, but enterprise teams strongly prefer GitHub Apps for fine-grained repository permissions.

Platform Architecture OverviewClick card to open

Instant 0-day approval. GitHub OAuth apps require no central manual review to serve external users, but enterprise teams strongly prefer GitHub Apps for fine-grained repository permissions.

Prod Pitfall:OAuth App vs. GitHub App Confusion
Unwritten Production Gotcha
warning
OAuth App vs. GitHub App Confusion

Traditional GitHub OAuth apps grant broad account-wide access (e.g. 'repo' scope grants read/write to ALL private repositories). For enterprise clients, use GitHub Apps instead to scope access to specific repositories.

Evidence: tested realityOpen Gotchas tab
8m0d wait
View
Slack

Slack

Communication

2.0/5
Friction: 2.0 / 5
Moderate
Moderate Friction (2.0 - 3.4)

Requires workspace admin authorization, granular scope permissions, or handling rigid token expiry.

Review Gate:Workspace Admin Only
Approval Wait:0 days (Instant)
Setup Effort:~12 mins
Compliance Cost:$0 (Free)
PKCE Protocol:Optional
Scale: 1.0 (Low) → 5.0 (High)Click card to view

Fast setup accelerated by Slack App Manifests. Public distribution across any workspace can be activated immediately without submitting to the Slack App Directory.

Platform Architecture OverviewClick card to open

Fast setup accelerated by Slack App Manifests. Public distribution across any workspace can be activated immediately without submitting to the Slack App Directory.

Prod Pitfall:Bot Token vs. User Token Scope Confusion
Unwritten Production Gotcha
critical
Bot Token vs. User Token Scope Confusion

Slack distinguishes between Bot Scopes (`chat:write`) and User Scopes (`chat:write.customize`). AI agents sending messages on behalf of a user need User scopes; agents posting as a bot persona need Bot scopes. Mixing them up causes authorization loops.

Evidence: tested realityOpen Gotchas tab
12m0d wait
View
Google Workspace (Gmail & Drive)

Google Workspace (Gmail & Drive)

Productivity

4.8/5
Friction: 4.8 / 5
High Friction
High Regulatory Gate (3.5 - 5.0)

Strict review required: mandatory directory submission, CASA security audit, or developer verification.

Review Gate:Google CASA Tier 2
Approval Wait:24 days wait
Setup Effort:~45 mins
Compliance Cost:$0 for basic; $3,000 - $15,000 if Restricted scopes trigger CASA Tier 2 Audit
PKCE Protocol:Optional
Scale: 1.0 (Low) → 5.0 (High)Click card to view

The highest-friction OAuth ecosystem. Triggers mandatory multi-week human review, domain verification via Search Console, unlisted YouTube video demos, and potential third-party security audits (CASA) if requesting sensitive or restricted scopes.

Platform Architecture OverviewClick card to open

The highest-friction OAuth ecosystem. Triggers mandatory multi-week human review, domain verification via Search Console, unlisted YouTube video demos, and potential third-party security audits (CASA) if requesting sensitive or restricted scopes.

Prod Pitfall:The 7-Day Token Expiration Trap (CRITICAL)
Unwritten Production Gotcha
critical
The 7-Day Token Expiration Trap (CRITICAL)

If your Google Cloud OAuth app publishing status is kept in 'Testing' mode, refresh tokens SILENTLY EXPIRE after 7 days! Your AI agent's background jobs will abruptly fail every week. You must push to 'In Production' to get non-expiring refresh tokens.

Evidence: tested realityOpen Gotchas tab
45m24d wait
View
Spotify

Spotify

Media & Content

3.5/5
Friction: 3.5 / 5
High Friction
High Regulatory Gate (3.5 - 5.0)

Strict review required: mandatory directory submission, CASA security audit, or developer verification.

Review Gate:Quota Extension Request
Approval Wait:21 days wait
Setup Effort:~15 mins
Compliance Cost:$0 (Free)
PKCE Protocol:Enforced (S256)
Scale: 1.0 (Low) → 5.0 (High)Click card to view

Fast initial prototype, but throttled by a hard 25-user development limit. Scaling beyond 25 beta testers requires an opaque 'Quota Extension Request' that takes 2 to 4 weeks.

Platform Architecture OverviewClick card to open

Fast initial prototype, but throttled by a hard 25-user development limit. Scaling beyond 25 beta testers requires an opaque 'Quota Extension Request' that takes 2 to 4 weeks.

Prod Pitfall:The 25-User Hard Quota Gate
Unwritten Production Gotcha
critical
The 25-User Hard Quota Gate

In Development mode, Spotify blocks any user whose email is not manually entered in the Developer Dashboard User Management tab. User #26 receives an immediate `User not registered on developer dashboard` error.

Evidence: tested realityOpen Gotchas tab
15m21d wait
View
Linear

Linear

Productivity

1.8/5
Friction: 1.8 / 5
Instant
Instant / Low Friction (1.0 - 1.9)

Zero review hurdles. Self-serve credentials and test tokens generated instantly in developer portal.

Review Gate:None
Approval Wait:0 days (Instant)
Setup Effort:~10 mins
Compliance Cost:$0 (Free)
PKCE Protocol:Enforced (S256)
Scale: 1.0 (Low) → 5.0 (High)Click card to view

Exceptionally developer-friendly. Instant internal workspace authorization, strict PKCE enforcement, and actor-scoped tokens with zero wait times for custom integrations.

Platform Architecture OverviewClick card to open

Exceptionally developer-friendly. Instant internal workspace authorization, strict PKCE enforcement, and actor-scoped tokens with zero wait times for custom integrations.

Prod Pitfall:Actor-Scoping (User vs App Tokens)
Unwritten Production Gotcha
tip
Actor-Scoping (User vs App Tokens)

Linear supports actor scoping: actions can be attributed either to the user who authorized the app or to the application bot itself.

Evidence: tested realityOpen Gotchas tab
10m0d wait
View
Notion

Notion

Productivity

2.2/5
Friction: 2.2 / 5
Moderate
Moderate Friction (2.0 - 3.4)

Requires workspace admin authorization, granular scope permissions, or handling rigid token expiry.

Review Gate:None
Approval Wait:0 days (Instant)
Setup Effort:~10 mins
Compliance Cost:$0 (Free)
PKCE Protocol:Optional
Scale: 1.0 (Low) → 5.0 (High)Click card to view

Instant internal workspace access with zero wait times. Public integrations require developer portal distribution approval with a privacy policy and terms of service.

Platform Architecture OverviewClick card to open

Instant internal workspace access with zero wait times. Public integrations require developer portal distribution approval with a privacy policy and terms of service.

Prod Pitfall:The Page-Level Permission Trap
Unwritten Production Gotcha
critical
The Page-Level Permission Trap

Unlike platforms that grant broad workspace access, Notion users must explicitly select which pages/databases the integration can access during the OAuth consent popup. If the user doesn't check a page, the agent receives empty search results.

Evidence: tested realityOpen Gotchas tab
10m0d wait
View
Salesforce

Salesforce

CRM & Sales

3.8/5
Friction: 3.8 / 5
High Friction
High Regulatory Gate (3.5 - 5.0)

Strict review required: mandatory directory submission, CASA security audit, or developer verification.

Review Gate:None
Approval Wait:0 days (Instant)
Setup Effort:~25 mins
Compliance Cost:$0 (Free with Developer Org)
PKCE Protocol:Enforced (S256)
Scale: 1.0 (Low) → 5.0 (High)Click card to view

Enterprise Connected App architecture. Immediate developer org usage, but requires careful handling of cluster replication delays and IP relaxation policies.

Platform Architecture OverviewClick card to open

Enterprise Connected App architecture. Immediate developer org usage, but requires careful handling of cluster replication delays and IP relaxation policies.

Prod Pitfall:The 10-Minute Global Cluster Replication Lag
Unwritten Production Gotcha
critical
The 10-Minute Global Cluster Replication Lag

For 2 to 10 minutes after saving a Connected App, all OAuth requests fail with 'invalid_client_id' while Salesforce replicates credentials across clusters. Developers frequently waste hours debugging code that isn't broken.

Evidence: tested realityOpen Gotchas tab
25m0d wait
View