Skip to main content
Connectors let your Base44 app work with the tools and data your business already uses, from Gmail and Slack to Google Workspace, Snowflake, and Databricks.
Connector tiles on a blue gradient with Gmail in focus

Connecting your app to external tools

​
About connectors

Connect the tools your team already works in, then build app flows on top of them.

Send reports and alerts

Email reports, alerts, or summaries through Gmail or Outlook.

Generate documents and files

Create documents, spreadsheets, presentations, or files using Google Workspace tools.

Manage events and availability

Create and manage events or availability using Google Calendar or Outlook.

Notify your team

Send notifications or updates to teams through Slack.

Track code and issues

Track code activity, issues, and pull requests with GitHub API.

Query data and build dashboards

Query external data and build dashboards with Snowflake or Databricks.

​
Connector types

A connector’s type determines whether everyone using your app shares one connection or each person connects their own account. You choose the type when you add the connector. Some connectors, such as Google Maps, don’t connect to anyone’s account. They’re always shared, and run on Base44 credentials or your own API key.

Shared connector

You connect one account once, and everyone who uses your app shares that connection and its data.Best for a team account or a data platform, like Slack alerts to your team’s channel or a Snowflake dashboard.

App user connector

Each person connects their own account, so your app can work with the data that account can access.Best for per-person actions, like a CRM where each sales rep sends email from their own Gmail.
Only workspace owners and admins can set up an app user connector. If you’re not one, the option is turned off when you add a connector, so ask an owner or admin to set it up.

​
Adding a connector

You add a connector from the Connectors page in your workspace, from an app, or by asking the AI chat.
In Base Code, you can’t add, remove, or change the permissions of connectors right now. This applies on main or on a branch, in the app editor and the AI chat.

​
From the Connectors page

Add a shared connector so everyone using your app can use the same connected account. To have each app user connect their own account instead, select App user connector in step 4, then follow Using your own OAuth client.
On the Pro plan and above, you can connect Google Calendar without setting up your own OAuth client.
To add a shared connector:
  1. Click Connectors in your workspace sidebar.
  2. Click Add connector.
  3. Search for the connector and click it.
  4. If the connector offers both types, select Shared connector, then click Next.
  5. Enter a Connection name.
  6. In Who can access, choose where the connection can be used: Apps and Super agent (the default), Apps only or Super agent only.
  7. Choose the scopes your app needs under Permissions:
    • Read-only: Your app can view data. This is the default.
    • Read & write: Your app can also send, create or change data.
    • Custom: Select the optional permissions your app needs. Required permissions stay selected.
    Some connectors, such as Notion and Contentful, show a list of permissions to select instead, and some, such as BambooHR, don’t show Permissions.
  8. Click Add connector, then authorize the account you want to share in the provider’s window.
To use a connector in your Superagent too, keep Apps and Super agent selected in Who can access. Your Superagent can then offer the connections you added when it asks you to connect in chat. Learn how to connect tools to your Superagent.

​
From your app

Add a shared connector without leaving the app you’re working on. To add a shared connector from an app:
  1. Click Dashboard in your app editor.
  2. Click Integrations.
  3. Click Add connector.
  4. Search for the connector and click it.
  5. If the connector offers both types, select Shared connector, then click Next.
  6. Choose the scopes your app needs under Permissions:
    • Read-only: Your app can view data. This is the default.
    • Read & write: Your app can also send, create or change data.
    • Custom: Select the optional permissions your app needs. Required permissions stay selected.
    Some connectors, such as Notion and Contentful, show a list of permissions to select instead, and some, such as BambooHR, don’t show Permissions.
  7. Click Add connector, then authorize the account in the provider’s window.

​
From the AI chat

Tell the AI chat what you want to connect and how you want to use it, and it suggests connectors based on your app’s structure, pages, and data. When a flow needs access, the chat shows a card asking you to approve the connection before it carries on building. To browse the full list with categories and example prompts, see the connectors catalog.

​
How connectors work in your app

Once you connect a tool, you can reuse it across pages, flows, and backend functions. Ask the AI chat to build pages, tables, dashboards, or automations that read from or write to the connector. When you include a connector in a flow, Base44 creates a backend function. To review its code, go to your app’s dashboard, click Code, and open the function under base44 > functions. You can edit it yourself or prompt the AI chat to update it. For example:
If you later add a flow that needs extra permissions, the AI chat asks you to approve the new permissions for that tool.
Code editor showing a backend function that posts a message to Slack through the connector.

Slack connector in backend functions

​
Using your own OAuth client

Some connectors run on your own OAuth client instead of Base44’s. You register the client with the provider, then add its credentials in your workspace, and the connector uses them from then on. The scopes you request from Google determine how much verification your app needs before it goes live. To choose the narrowest scopes and plan for verification, see Google Workspace connectors.
Before you begin: You need to be a workspace owner or admin. Register an OAuth application with the provider and get its credentials.When you fill in the connector form, copy the Callback URL and add it to the provider’s allowed redirect URIs before you save. In some workspaces, and for connections still on per-app URLs, the form shows a View redirect URIs button instead:
  • Click it and select each app under App.
  • Add every URL listed under Builder and Live app.
To add a connector with your own OAuth client:
  1. Click Connectors in your workspace sidebar.
  2. Click Add connector.
  3. Search for the connector and click it.
  4. If the connector offers both types, select App user connector, then click Next. Some connectors, such as Snowflake and Databricks, open this form directly.
  5. Enter a Connector name to identify this configuration.
  6. Enter your Client ID and, if required, Client Secret. Complete any other fields shown for your connector.
  7. Review the required scopes under Scopes and select any optional scopes your app needs. For scopes not listed, enter one per line in Additional scopes.
  8. Click Add Connector.
Treat your Client Secret like a password. Don’t share it or include it in screenshots.

​
Switching an older connection

New connections use one callback URL, https://connectors.base44.com/api/oauth/callback, for all your apps and custom domains, so you register it once. Connections you added before August 17, 2026 register a separate URL for each app host, and they show a Per-app URLs badge next to their name. Each connection is switched over on its own, so one connector can have some connections on the single callback URL and others still on per-app URLs. Switching is worth doing if you’re adding apps or custom domains and keep registering a new URL for each one. If your setup is stable and working, there’s no need to switch. Existing connections keep working on their per-app URLs for as long as you leave them there.
Keep your existing per-app callback URLs registered with your provider when you switch. People who connected before the switch still need them, and changes in your provider can take a few minutes to take effect.
To switch a connection to the single callback URL:
  1. Click Connectors in your workspace sidebar.
  2. Next to the connector, click View.
  3. Next to the connection, click View connection.
  4. If Callback URLs shows Uses per-app callback URLs, click Switch to a single URL.
  5. Add the URL shown to your OAuth provider’s allowed redirect URIs. Select I’ve added the URL to my OAuth provider, then click Switch.
To move a connection back later, open it again and click Switch back to per-app URLs. Check that your provider still has the per-app URLs registered first, because a connection created on the single callback URL may never have had them.

​
Managing your connectors

Keep each app’s connections working. Reconnect one that expired, remove one you no longer need, or connect one to your workspace so other apps can reuse it. For an app user connector, each person reconnects their own account from inside your app. To manage a connection:
  1. Click Dashboard in your app editor.
  2. Click Integrations.
  3. Find the connection under App connections.
  4. Click the Integration actions icon and select an option:
    • Reconnect to restore a connection that expired or was revoked.
    • Remove to delete the connection from this app.

​
Moving a connection to your workspace

A connection you add inside an app works only in that app. Move it to your workspace so other apps in your workspace can reuse it without connecting the same account again. Your app keeps using it. You can move a connection if you can edit in your workspace and the connection signs in to an account. Connections that use Base44 credentials or an API key, or that ask for extra details when you connect, stay in their app. To move an app connection to your workspace:
  1. Go to your app editor.
  2. Click Dashboard.
  3. Click Integrations.
  4. Find the connection under App connections.
  5. Click Connect to workspace. On a narrow screen, click the Integration actions icon first.
  6. Sign in to the account in the provider’s window.
A connection you move is set to Apps only. To use it in your Superagent too, edit the connection and change Who can access to Apps and Super agent.

​
Managing workspace OAuth configurations

Workspace OAuth configurations are separate from the accounts connected inside an app. You can edit their credentials and scopes, add another connection, or delete a configuration.
Deleting a workspace OAuth configuration can’t be undone.
To manage a workspace OAuth configuration:
  1. Click Connectors in your workspace sidebar.
  2. Next to the connector, click View.
  3. Choose what to do:
    • To edit a configuration, next to the connection click View connection. Update the name, credentials, or scopes, then click Save Changes. Leave Client Secret empty to keep the existing secret. You can also change Who can access there.
    • To add another connection to the same connector, such as the other connector type, click Add another connector.
    • To delete a configuration, next to the connection click View connection, then click Delete Connector and confirm.
Scope changes apply to new connections. People who already connected keep their approved access until they connect again. Scope lists can also change on the provider’s side, so always review the permissions shown during the connection flow.

​
Controlling workspace availability

On a Business or Enterprise plan, workspace owners and admins can choose which connectors people in the workspace can use. See Managing connector availability for your workspace.

​
FAQs

You may need to reconnect if the account was disconnected, its access was revoked, or the connected service requires you to sign in again. For the steps, see Managing your connectors above.
When you use your own OAuth client, the callback URL registered with the service has to match the one Base44 sends, exactly. Check that https://connectors.base44.com/api/oauth/callback is registered in your OAuth app. If the connection is still on per-app URLs, every URL it lists has to be registered instead. To find them, see Using your own OAuth client above.
An app user connector only works for the people your own OAuth app admits. Most providers hold a new OAuth app to a test or internal audience until you publish or distribute it, so check the audience setting on your OAuth app with the provider.
Need more control over a specific API? Use a custom integration.