> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# Integrations

> Connect an app to third-party accounts through connectors with the Base44 Apps API

<Note>
  The Apps API is in beta. Its endpoints and responses may change.
</Note>

These endpoints connect an app to third-party accounts through connectors. List the connectors available, start a connection with OAuth, check its status, and disconnect or remove a connector.

## Connect a connector

A person has to approve access in the provider's own sign-in, so connecting takes three steps.

**To connect a connector:**

1. Call [List connectors](/api-reference/list-connectors) and note the `integration_type` of the one you want. If it needs values such as an account subdomain, read them with [Get connector connection fields](/api-reference/get-connector-connection-fields).
2. Call [Start connector connection](/api-reference/start-connector-connection) and open the `redirect_url` it returns in a browser. The person signs in to the provider and approves access.
3. Poll [Get connector connection status](/api-reference/get-connector-connection-status) until `status` is `ACTIVE` or `FAILED`.

Treat the `redirect_url` as a credential. Whoever approves access through it connects their provider account to the app.

## Disconnect and remove a connector

[Disconnect connector](/api-reference/disconnect-connector) stops the app from using the connected account. [Remove connector](/api-reference/remove-connector) does that and also deletes the connector from the app, including its file in the app's code, so connecting it again starts from scratch.

## Endpoints

* [List connectors](/api-reference/list-connectors): List the connectors you can connect to an app.
* [List connector connections](/api-reference/list-connector-connections): List the app's connections and whether each still works.
* [Get connector connection fields](/api-reference/get-connector-connection-fields): Read the values a connector needs before you connect it.
* [Start connector connection](/api-reference/start-connector-connection): Start an OAuth connection and get the sign-in link.
* [Get connector connection status](/api-reference/get-connector-connection-status): Check where a connection you started stands.
* [Disconnect connector](/api-reference/disconnect-connector): Disconnect a connector from the app.
* [Remove connector](/api-reference/remove-connector): Remove a connector from the app completely.
* [Get connector policies](/api-reference/get-connector-policies): Read which connectors the workspace lets builders and app users connect.


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