# BundleUp

- [Introduction](https://bundleup.io/docs/index.md): BundleUp connects your product to your users’ third-party accounts, then lets you call those accounts from your backend, your Unified API calls, or your AI agents.
- [Why BundleUp](https://bundleup.io/docs/why-bundleup.md): What it takes to build third-party integrations yourself, what BundleUp takes off your plate, and what stays in your hands.
- [How BundleUp Works](https://bundleup.io/docs/how-it-works.md): The parts of BundleUp, where they run, and what happens to a single request from your backend to a provider and back.
- [Use Cases](https://bundleup.io/docs/use-cases.md): Common things teams build with BundleUp, and which parts of BundleUp each one uses.
- [Proxy vs Unified API vs MCP](https://bundleup.io/docs/choosing-a-surface.md): Three ways to call a connected account. How to choose between them, and why you don’t have to choose only one.
- [Quickstart](https://bundleup.io/docs/quickstart.md): From a new BundleUp account to your first API call against a user’s connected account, in about five minutes.
- [Next.js Quickstart](https://bundleup.io/docs/quickstart/next-js.md): Connect your first integration with a Next.js app using the BundleUp JavaScript SDK.
- [Django Quickstart](https://bundleup.io/docs/quickstart/django.md): Connect your first integration with a Django app using the BundleUp Python SDK.
- [Rails Quickstart](https://bundleup.io/docs/quickstart/rails.md): Connect your first integration with a Ruby on Rails app using BundleUp.
- [AI Agent Quickstart](https://bundleup.io/docs/quickstart/ai-agent.md): Let an AI agent act in a user’s connected account through MCP, without the agent ever seeing a token.
- [Core Concepts](https://bundleup.io/docs/concepts/overview.md): The handful of objects BundleUp is built on, and how they relate to each other.
- [Workspaces](https://bundleup.io/docs/concepts/workspaces.md): A workspace is the boundary for everything in BundleUp: integrations, connections, keys, webhooks, members, billing.
- [Integrations](https://bundleup.io/docs/concepts/integrations.md): An integration is a provider configured for your workspace, using your own OAuth app and the scopes you choose.
- [Connections](https://bundleup.io/docs/concepts/connections.md): A connection is one end user’s authorized account at one provider. Its ID is what you pass on every request.
- [Requests & Usage](https://bundleup.io/docs/concepts/requests.md): What a request is, what gets logged about it, and how requests count toward your plan.
- [API Keys & Client ID](https://bundleup.io/docs/concepts/api-keys.md): The two credentials you use with BundleUp: a secret API key for your backend, and a public client ID for the browser.
- [Glossary](https://bundleup.io/docs/concepts/glossary.md): Every BundleUp term in one place.
- [Connecting User Accounts](https://bundleup.io/docs/guides/auth/authorization-flow.md): Send a user through BundleUp’s hosted OAuth flow, get a one-time code back, and exchange it for a connection ID.
- [Authenticating API Requests](https://bundleup.io/docs/guides/auth/authenticating-requests.md): Every Proxy, Unified API and MCP request carries two things: your API key, and the connection ID of the account to act on.
- [Connection Lifecycle](https://bundleup.io/docs/guides/auth/connection-lifecycle.md): How a connection is created, how its tokens are kept fresh, what happens when a refresh fails, and how connections end.
- [Setting Up an Integration](https://bundleup.io/docs/guides/integrations/creating.md): Register an OAuth app with a provider, then connect it to BundleUp so your users can authorize their accounts.
- [Choosing Scopes](https://bundleup.io/docs/guides/integrations/scopes.md): Scopes decide what a connection can do. How to pick them, and how they affect the Proxy, the Unified API and MCP.
- [Proxy Overview](https://bundleup.io/docs/guides/proxy/overview.md): Call any provider’s own API as a connected user, with authentication, token refresh, retries, rate limiting and logging handled for you.
- [Making Proxy Requests](https://bundleup.io/docs/guides/proxy/making-requests.md): Paths, methods, headers, bodies, GraphQL and binary data through the BundleUp Proxy.
- [Retries](https://bundleup.io/docs/guides/proxy/retries.md): Which requests BundleUp retries automatically, how long it waits, and how to change the retry count.
- [Rate Limits](https://bundleup.io/docs/guides/proxy/rate-limits.md): Each connection can make 100 requests per 60 seconds through BundleUp. How the limit works and how to handle it.
- [Unified API Overview](https://bundleup.io/docs/guides/unified/overview.md): One request and response shape per category, across every provider in that category.
- [Unified API Conventions](https://bundleup.io/docs/guides/unified/conventions.md): Base URL, headers, response envelope, pagination, raw responses, provider parameters and errors: the rules every Unified API endpoint follows.
- [Account](https://bundleup.io/docs/guides/unified/account.md): Find out who a connection is authenticated as, with one endpoint that every integration supports.
- [Chat](https://bundleup.io/docs/guides/unified/chat.md): List users, channels and messages, and send messages, across chat providers with one API.
- [Git](https://bundleup.io/docs/guides/unified/git.md): Repositories, pull requests, issues, tags, releases, branches and commits across Git hosts with one API.
- [Tasks](https://bundleup.io/docs/guides/unified/tasks.md): Tasks and projects from issue trackers and project tools, in one shape.
- [Helpdesk](https://bundleup.io/docs/guides/unified/helpdesk.md): Support tickets from customer service tools, in one shape.
- [CRM](https://bundleup.io/docs/guides/unified/crm.md): Companies and contacts from CRMs, in one shape.
- [Drive](https://bundleup.io/docs/guides/unified/drive.md): Files and folders from cloud storage providers, in one shape.
- [Calendar](https://bundleup.io/docs/guides/unified/calendar.md): Calendar events, meetings and bookings in a time window, in one shape.
- [MCP Overview](https://bundleup.io/docs/guides/mcp/overview.md): Give AI agents access to a user’s connected accounts through the providers’ own MCP servers, without handing the agent a token.
- [How Proxy MCP Works](https://bundleup.io/docs/guides/mcp/proxy-mcp.md): What BundleUp does to each MCP message on its way to the provider’s MCP server, and what it leaves alone.
- [Using MCP Clients](https://bundleup.io/docs/guides/mcp/clients.md): Connect OpenAI, Anthropic, the MCP SDKs, or Claude Code to a user’s account through mcp.bundleup.io.
- [Agents for Many Users](https://bundleup.io/docs/guides/mcp/multi-tenant-agents.md): Run one agent for all your users, give each user their own accounts, and combine several providers in one agent.
- [Webhooks](https://bundleup.io/docs/guides/webhooks/overview.md): Get an HTTP request on your server when integrations or connections change in your workspace.
- [Webhook Events](https://bundleup.io/docs/guides/webhooks/events.md): Every event BundleUp can send, when it fires, and what its payload contains.
- [Verifying Webhook Signatures](https://bundleup.io/docs/guides/webhooks/verifying.md): Check that a webhook really came from BundleUp, and that it isn’t a replay.
- [Logs & Observability](https://bundleup.io/docs/guides/operations/logs.md): See every request made through BundleUp: what was called, how it went, and how long it took.
- [Handling Errors](https://bundleup.io/docs/guides/operations/error-handling.md): Tell BundleUp errors from provider errors, and decide what to do about each.
- [Production Checklist](https://bundleup.io/docs/guides/operations/going-to-production.md): What to check before you launch an integration built on BundleUp.
- [Troubleshooting & FAQ](https://bundleup.io/docs/guides/operations/troubleshooting.md): Common problems and their fixes, plus answers to frequent questions.
- [Dashboard Tour](https://bundleup.io/docs/platform/dashboard.md): What each section of the BundleUp dashboard is for.
- [Team & Members](https://bundleup.io/docs/platform/team.md): Invite teammates to a workspace and control what each of them can do.
- [Security](https://bundleup.io/docs/platform/security.md): How BundleUp protects your users’ credentials and data, and what you’re responsible for.
- [Pricing & Plans](https://bundleup.io/docs/platform/pricing.md): You pay for requests. Not for integrations, connections, users or workspaces.
- [Limits & Quotas](https://bundleup.io/docs/platform/limits.md): Every number that shapes how BundleUp behaves, in one place.
- [API Reference](https://bundleup.io/docs/api-reference/introduction.md): Base URLs, authentication and conventions for every BundleUp API.
- [Headers](https://bundleup.io/docs/api-reference/headers.md): Every header BundleUp reads or sends, and which APIs use it.
- [Errors](https://bundleup.io/docs/api-reference/errors.md): Every error BundleUp returns, by API, and how to tell them apart from provider errors.
- [Authorize](https://bundleup.io/docs/api-reference/auth/authorize.md): Start the authorization flow. Open this URL in the user’s browser.
- [Exchange a Code](https://bundleup.io/docs/api-reference/auth/exchange-code.md): Turn the one-time code from the authorization redirect into a connection ID.
- [Proxy](https://bundleup.io/docs/api-reference/proxy.md): Forward any request to the connected provider’s API with the user’s credentials.
- [MCP](https://bundleup.io/docs/api-reference/mcp.md): Forward MCP messages to the connected provider’s MCP server with the user’s credentials.
- [Unified API](https://bundleup.io/docs/api-reference/unified-api.md): Normalized endpoints for account, chat, git, tasks, helpdesk, CRM, drive and calendar data.
- [List users](https://bundleup.io/docs/api-reference/chat/list-users.md): List chat users for Slack and Discord
- [List channels](https://bundleup.io/docs/api-reference/chat/list-channels.md): List chat channels for Slack and Discord
- [List messages](https://bundleup.io/docs/api-reference/chat/list-messages.md): List messages in a chat channel for Slack and Discord. Newest first. `author.name` is null on Slack, which returns only a user id on a message.
- [Send message](https://bundleup.io/docs/api-reference/chat/send-message.md): Send a chat message
- [List repositories](https://bundleup.io/docs/api-reference/git/list-repositories.md): List git repositories for GitHub, GitLab and Bitbucket
- [List pull requests](https://bundleup.io/docs/api-reference/git/list-pull-requests.md): List pull requests for a git repository on GitHub, GitLab and Bitbucket
- [List issues](https://bundleup.io/docs/api-reference/git/list-issues.md): List issues for a git repository on GitHub, GitLab and Bitbucket
- [List tags](https://bundleup.io/docs/api-reference/git/list-tags.md): List tags for a git repository on GitHub, GitLab and Bitbucket
- [List releases](https://bundleup.io/docs/api-reference/git/list-releases.md): List releases for a git repository on GitHub and GitLab
- [List branches](https://bundleup.io/docs/api-reference/git/list-branches.md): List branches for a git repository on GitHub, GitLab and Bitbucket
- [List commits](https://bundleup.io/docs/api-reference/git/list-commits.md): List commits for a git repository on GitHub, GitLab and Bitbucket
- [List tasks](https://bundleup.io/docs/api-reference/tasks/list-tasks.md): List tasks for Jira, Linear, Asana, Trello, ClickUp, monday.com, Basecamp, Wrike and Todoist
- [Get task](https://bundleup.io/docs/api-reference/tasks/get-task.md): Retrieve a single task by ID for Jira, Linear, Asana, Trello, ClickUp, monday.com, Wrike and Todoist. Basecamp is not supported: its API only serves a to-do underneath its project, so an id on its own cannot address one.
- [List projects](https://bundleup.io/docs/api-reference/tasks/list-projects.md): List projects for Jira, Linear, Asana, Trello, ClickUp, monday.com, Basecamp, Wrike and Todoist
- [List tickets](https://bundleup.io/docs/api-reference/helpdesk/list-tickets.md): List support tickets for Zendesk, ServiceNow, Zoho Desk, Gorgias and Help Scout
- [Get ticket](https://bundleup.io/docs/api-reference/helpdesk/get-ticket.md): Retrieve a single support ticket by ID for Zendesk, ServiceNow, Zoho Desk, Gorgias and Help Scout
- [List CRM companies](https://bundleup.io/docs/api-reference/crm/list-crm-companies.md): List CRM companies for Apollo, Attio, Close, Copper, HubSpot, Microsoft Dynamics 365, PipeDrive, Salesforce and Zoho CRM
- [List CRM contacts](https://bundleup.io/docs/api-reference/crm/list-crm-contacts.md): List CRM contacts for Apollo, Attio, Close, Copper, HubSpot, Microsoft Dynamics 365, PipeDrive, Salesforce and Zoho CRM
- [List Drive files](https://bundleup.io/docs/api-reference/drive/list-drive-files.md): List files from Google Drive, OneDrive, Box, Dropbox and Microsoft SharePoint
- [List calendar events](https://bundleup.io/docs/api-reference/calendar/list-calendar-events.md): List calendar events for Google Calendar, Outlook, Calendly and Zoom. The window is required: every provider either demands one or would otherwise return years of history. Recurring events are expanded into their individual occurrences, so each entry describes a real date.
- [Get connected account](https://bundleup.io/docs/api-reference/identity/get-connected-account.md): Retrieve the account a connection is authenticated as. Providers that authorize per workspace, portal, tenant or company return that account instead of a user, and fields the provider does not expose come back as null.
- [Platform API](https://bundleup.io/docs/api-reference/platform-api.md): Manage connections, integrations and webhooks in your workspace.
- [List integrations](https://bundleup.io/docs/api-reference/integrations/list-integrations.md): Returns integrations for the authenticated workspace.
- [Get integration](https://bundleup.io/docs/api-reference/integrations/get-integration.md): Returns a single integration for the authenticated workspace.
- [List connections](https://bundleup.io/docs/api-reference/connections/list-connections.md): Returns connections for the authenticated workspace.
- [Create connection](https://bundleup.io/docs/api-reference/connections/create-connection.md): Creates a connection for the authenticated workspace.
- [Get connection](https://bundleup.io/docs/api-reference/connections/get-connection.md): Returns a single connection for the authenticated workspace.
- [Delete connection](https://bundleup.io/docs/api-reference/connections/delete-connection.md): Deletes a connection and attempts to revoke the provider token.
- [Update connection](https://bundleup.io/docs/api-reference/connections/update-connection.md): Updates a connection for the authenticated workspace.
- [List webhooks](https://bundleup.io/docs/api-reference/webhooks/list-webhooks.md): Returns webhooks for the authenticated workspace.
- [Create webhook](https://bundleup.io/docs/api-reference/webhooks/create-webhook.md): Creates a webhook for the authenticated workspace.
- [Get webhook](https://bundleup.io/docs/api-reference/webhooks/get-webhook.md): Returns a single webhook for the authenticated workspace.
- [Delete webhook](https://bundleup.io/docs/api-reference/webhooks/delete-webhook.md): Deletes a webhook for the authenticated workspace.
- [Update webhook](https://bundleup.io/docs/api-reference/webhooks/update-webhook.md): Updates a webhook for the authenticated workspace.
- [SDKs](https://bundleup.io/docs/sdks/overview.md): Official BundleUp SDKs for JavaScript/TypeScript, Python and Ruby.
- [JavaScript](https://bundleup.io/docs/sdks/javascript.md)
- [Python](https://bundleup.io/docs/sdks/python.md)
- [Ruby](https://bundleup.io/docs/sdks/ruby.md)

## OpenAPI Specs

- [openapi](https://api.bundleup.io/v1/openapi.yml)
- [openapi](https://unify.bundleup.io/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.