# OAuth Field Guide

> How to register a provider's OAuth app and get it approved so your users can connect their accounts: difficulty, hands-on work vs approval wait, steps tagged agent/human/provider, and sources.

## Use from an agent

- [MCP server](https://oauth-guide.akshatsethi.com/api/mcp): Streamable HTTP. Tools: list_guides, get_guide, research_app, research_status, report_problem, report_setup
- Guide as Markdown: https://oauth-guide.akshatsethi.com/apps/{slug}.md
- Agent instructions: https://oauth-guide.akshatsethi.com/api/guides/{slug}?format=prompt
- Research a new app: POST https://oauth-guide.akshatsethi.com/api/research with {"query": "calendly.com"}
- Report a wrong guide: POST https://oauth-guide.akshatsethi.com/api/reports with {"app": "slack", "step": 2, "message": "what you saw"} (step is optional)
- Say how a setup went: POST https://oauth-guide.akshatsethi.com/api/reports with {"app": "slack", "outcome": "worked" | "waiting" | "stuck", "step": 3, "message": "what happened"}

## Guides

- [Notion](https://oauth-guide.akshatsethi.com/apps/notion.md): Self-serve. Work 30–90 min, wait none.
- [Calendly](https://oauth-guide.akshatsethi.com/apps/calendly.md): Self-serve. Work 20–60 min, wait none.
- [Linear](https://oauth-guide.akshatsethi.com/apps/linear.md): Self-serve. Work 15–45 min, wait none.
- [Slack](https://oauth-guide.akshatsethi.com/apps/slack.md): Capped. Work 1–3 h, wait none.
- [Salesforce](https://oauth-guide.akshatsethi.com/apps/salesforce.md): Self-serve. Work 1–3 days, wait none.
- [Gmail](https://oauth-guide.akshatsethi.com/apps/gmail.md): Gated. Work 3–10 days, wait 2–8 weeks.
- [Spotify](https://oauth-guide.akshatsethi.com/apps/spotify.md): Gated. Work 2–8 h, wait 0–6 weeks.
- [X](https://oauth-guide.akshatsethi.com/apps/x.md): Gated. Work 30–90 min, wait none.
- [HubSpot](https://oauth-guide.akshatsethi.com/apps/hubspot.md): Capped. Work 1–3 days, wait 2–12 weeks.
- [Zoom](https://oauth-guide.akshatsethi.com/apps/zoom.md): Reviewed. Work 1–4 days, wait 2–12 weeks.
- [Pinterest](https://oauth-guide.akshatsethi.com/apps/pinterest.md): Reviewed. Work 3–8 h, wait unknown.
- [Monzo](https://oauth-guide.akshatsethi.com/apps/monzo.md): Gated. Work unknown, wait unknown.
- [Mastodon](https://oauth-guide.akshatsethi.com/apps/mastodon.md): Self-serve. Work 1–4 h, wait none.
- [WeChat](https://oauth-guide.akshatsethi.com/apps/wechat.md): Gated. Work 2–6 h, wait 4–14 days.
- [Zendesk](https://oauth-guide.akshatsethi.com/apps/zendesk.md): Reviewed. Work 4–10 h, wait unknown.
- [Figma](https://oauth-guide.akshatsethi.com/apps/figma.md): Reviewed. Work 2–6 h, wait 1–5 weeks.
- [Google Drive](https://oauth-guide.akshatsethi.com/apps/google-drive.md): Gated. Work 3–10 days, wait 2–8 weeks.
- [GitHub](https://oauth-guide.akshatsethi.com/apps/github.md): Self-serve. Work 10–30 min, wait none.

## No OAuth (researched, no guide)

- [Apple Music](https://oauth-guide.akshatsethi.com/apps/apple-music.md)
- [Instagram Basic Display](https://oauth-guide.akshatsethi.com/apps/instagram-basic-display.md): try Instagram API with Instagram Login

## Queued (no guide yet)

Google Calendar, Xero, DocuSign, Stripe, Jira, Confluence, Asana, Dropbox, Airtable, Trello, Discord, Microsoft Outlook, Microsoft Teams, Intercom, Mailchimp, YouTube, Todoist, Sentry, Shopify, Snowflake, Vercel, Pipedrive, Klaviyo, Datadog, PayPal, Webflow, Workday, ServiceNow, Smartsheet, LinkedIn, QuickBooks