Skip to main content

About connectors

Connectors are OAuth-enabled integrations that let you connect your Base44 app to tools such as Gmail, Google Workspace tools, BigQuery, Slack, Notion, Salesforce, HubSpot, LinkedIn, and TikTok. When you connect a tool, you authorize access to your own account in that tool. The connector uses that account at the app level so your app can read or write data according to the permissions you approve. Each app uses one account per connected tool, and all flows in that app share the same connection.
Connectors are shared across your app. Connected accounts are app-level, not per person. Do not use connectors for private per-user data, for example in a multi-user app where each person expects to connect their own calendar or inbox. Only use connectors when everyone who can access the app is allowed to see the same external data.
You need a Builder plan or higher to use connectors.

Adding a connector

Connect your app to a tool by prompting the Base44 AI chat. Describe exactly what you want the app to do. You can also use the example prompts as a starting point by going to IntegrationsBrowse in your app’s dashboard.
Using connectors in Base44
Examples of using connectors:
  • Send daily task summaries or reports through Gmail.
  • Trigger Gmail alerts when important actions happen in your app.
  • Save files from your app to Google Drive.
  • Block off time in Google Calendar when a new booking is made.
  • Connect BigQuery to power a data agent and analytics dashboards.
  • Post updates to a Slack channel.
  • Sync a Notion database to power a knowledge view in your app.
  • Sync Salesforce or HubSpot records into an internal dashboard.
  • Publish a LinkedIn post when a new blog post is published.
  • Show TikTok profile stats and follower count in a dashboard.
Before connecting, activate backend functions in your app’s dashboard.
To connect your app to a tool:
  1. In your app editor, open the AI chat.
  2. Describe what you want the app to do, or use a ready-made prompt:
    • In the AI chat, specify what you want the app to do.
    • Go to your app’s dashboard and click IntegrationsBrowse, then click Use on a connector. Click an example prompt to add it to the chat and edit it if needed.
  3. Review the Action required and Required permissions.
  4. Click Connect to [tool].
  5. Complete the sign-in authorization.
Approving access lets your app use your account only with the permissions listed for the connector in this app. If you click Skip, the tool is not connected to your app and you can request the connection again later.
Some tools require additional steps on their platform after connecting to your Base44 app.

Prompt examples

Copy an example prompt below to get started and get the most out of your connectors.
Connect to my Gmail. I want to receive a daily email with my to do list.
Email me a summary of all new signups from today using my Gmail account.
Send a Gmail alert to me when a new task is marked as high priority.
Send a weekly Gmail digest with key metrics from this dashboard.
Email my team from Gmail when a deal moves to the Closed Won stage.
Sync all my bookings directly to my Google Calendar.
Show my real-time availability from Google Calendar to clients.
Save generated PDF reports from my app to Google Drive.
Create a Google Doc with a daily summary of activity from my app.
Sync new records from this app into a Google Sheets spreadsheet.
Keep a Google Sheets dashboard updated with daily metrics from my app.
Generate a Google Slides presentation summarizing this week’s key KPIs.
Connect your Base44 app directly to Google BigQuery to power a data agent that queries your analytics warehouse in natural language. Ask questions about metrics, performance, and trends, and surface answers instantly inside your app, without writing SQL or managing API keys. Connect the agent to WhatsApp to ask those questions in a WhatsApp chat and get real-time answers.
Bigquerywhatsapp 1
Connect this app to my BigQuery project and add a data agent that answers questions about my analytics.
Let users ask questions about sales trends from my BigQuery dataset.
Connect BigQuery and allow leadership to query KPI metrics from WhatsApp.
Build a dashboard powered by BigQuery and let the agent explain performance changes.
Post a message to the #support channel when a new ticket is created.
Send a daily summary of completed tasks to my team's Slack channel.
Notify me in Slack when a sale is made in my app.
Share important updates in the #announcements channel when a document is approved.
Send alerts to a Slack channel when deadlines are approaching.
Sync a Notion database with my CRM records.
Write project updates from this app into a Notion page.
Show Notion checklist progress for team onboarding in my dashboard.
Create new Notion pages for every new client added in my app.
Post meeting notes from the app to a specific Notion page.
Sync new leads from this app into Salesforce.
Show Salesforce opportunity stages inside my project dashboard.
Log customer support requests in Salesforce automatically.
Update Salesforce contact records when app data changes.
Pull recent Salesforce tasks into a daily action list in my app.
Sync new leads from this app into HubSpot contacts.
Show HubSpot deal stages inside my project dashboard.
Create HubSpot contacts when users sign up in my app.
Update HubSpot deal values when orders are placed.
Import HubSpot contact lists to segment users in my app.
Post a status update to my LinkedIn feed when I publish a new article.
Share company announcements to my LinkedIn profile.
Display my LinkedIn profile information in my dashboard.
Post project milestones to LinkedIn automatically.
Create a LinkedIn post when a new blog post is published.
Show my TikTok profile stats and follower count in a dashboard.
List my recent TikTok videos with their view counts.
Display my TikTok bio and verification status.
Show my total likes, followers, and video count from TikTok.
Create a gallery of my TikTok videos.

Using connectors

Once you connect a tool to your app, you can reuse it across pages, flows, and backend functions in that app. In the AI chat, you can ask Base44 to build pages, tables, dashboards, or automations that read from or write to that connector. When you include a connector in a flow, Base44 also creates a backend function in DashboardCodeFunctions. Open that function to review the generated code. You can edit it yourself or prompt the AI chat to update it so it uses the connector the way you need. For example: Send a Slack message to #product-updates when this function runs. If you later add a flow that needs extra permissions, you may be asked to review and approve the new actions and permissions for that tool.
Code editor showing a Base44 backend function that posts a message to the #product-updates Slack channel.

Managing connectors

View and manage your app’s connectors, review what each can access, and switch or disconnect the connected account per tool as needed.
App dashboard showing the Integrations page with the My integrations tab selected, listing connected tools and a View access button.
To manage your connectors:
  1. Go to your app’s dashboard and click Integrations.
  2. Click the My integrations tab.
  3. For each connector, choose what you want to do:
    • View access: Check the permissions granted to the app.
    • More actions: Switch or disconnect an account. The new account is used for future actions.
    • Reconnect: Connect an account again.

Connector permissions

When you connect a tool, the connector requests a set of permissions, also called scopes. They define what your app can do with the connected account. Depending on what you build, you are prompted to authorize only the permissions that the flow needs. Base44 only uses permissions to support the features you enable, so you always stay in control of what your app can access.
Important: The use of raw and derived information received from Google Workspace APIs will adhere to the Google User Data Policy, including the Limited Use requirements.
AI chat showing the Slack connector with required permissions and a Connect to Slack button.
Click a connector below to see the permissions it may request, depending on the flows you build.
Scope lists can change as providers update their APIs. Always review the permissions shown when you connect a tool because they reflect the current access your app is requesting.
These permissions allow your app to send and manage email using your connected Gmail account. Base44 also requests access to the connected Google account email address to display which account is connected in the dashboard.
https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.send
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.compose
These permissions allow your app to work with Google Calendar, Docs, Sheets, Slides, and Drive files that it creates or is granted access to.Calendar
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.events.readonly
https://www.googleapis.com/auth/calendar.events.freebusy
https://www.googleapis.com/auth/calendar.freebusy
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.calendarlist.readonly
https://www.googleapis.com/auth/calendar.events.public.readonly
https://www.googleapis.com/auth/calendar.settings.readonly
Docs
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/documents.readonly
Sheets
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/spreadsheets.readonly
Slides
https://www.googleapis.com/auth/presentations
https://www.googleapis.com/auth/presentations.readonly
Drive
https://www.googleapis.com/auth/drive.file
These permissions allow your app to read data from BigQuery datasets and tables.
https://www.googleapis.com/auth/bigquery.readonly
The Slack connector requests permissions required to read and manage channels, messages, files, reactions, reminders, user data, and workspace settings.
channels:read
channels:write
channels:history
chat:write
chat:read
files:read
files:write
groups:read
groups:write
groups:history
im:read
im:write
im:history
mpim:read
mpim:write
mpim:history
reactions:read
reactions:write
users:read
users:read.email
team:read
usergroups:read
usergroups:write
pins:read
pins:write
bookmarks:read
bookmarks:write
reminders:read
reminders:write
stars:read
stars:write
search:read
emoji:read
dnd:read
dnd:write
links:read
links:write
The Notion connector allows your app to read and update content, create pages and comments, and access user information within the workspace you authorize.
read_content
update_content
insert_content
read_comments
create_comments
read_users
These permissions allow your app to access Salesforce APIs, user identity data, CRM records, content, analytics, marketing tools, and customer data platform services.
api
refresh_token
full
web
id
openid
profile
email
address
phone
offline_access
custom_permissions
wave_api
chatter_api
visualforce
content
cdp_api
cdp_profile_api
cdp_query_api
cdp_segment_api
interaction_api
cdp_ingest_api
pardot_api
These permissions allow your app to read and write CRM data, manage deals, quotes, tickets, marketing tools, automation, forms, files, and analytics data.
crm.objects.contacts.read
crm.objects.contacts.write
crm.objects.companies.read
crm.objects.companies.write
crm.objects.deals.read
crm.objects.deals.write
crm.objects.owners.read
crm.objects.quotes.read
crm.objects.quotes.write
crm.lists.read
crm.lists.write
crm.schemas.contacts.read
crm.schemas.companies.read
crm.schemas.deals.read
tickets
e-commerce
automation
forms
files
content
social
analytics.read
These permissions allow your app to manage profiles, company pages, posts, and advertising insights.
openid
profile
r_ads_reporting
r_organization_social
rw_organization_admin
w_member_social
r_profile_basicinfo
r_ads
r_verify
w_organization_social
rw_ads
r_basicprofile
r_organization_admin
email
r_1st_connections_size
These permissions allow your app to access profile data and read performance metrics.Product
Login Kit
Permissions
artist.certification.read
artist.certification.update
user.info.basic
user.info.profile
user.info.stats
video.list

Individual account connections

Connectors are app level integrations. When you connect a tool like LinkedIn, Slack, Gmail, Google Workspace, or BigQuery, your Base44 app uses a single shared account for that connector that everyone in the app shares. If you need each person to connect their own account, you need to create a custom per user OAuth flow using backend functions and the provider’s API. Connectors do not support this scenario.
Important: Per user OAuth is an advanced integration pattern. Exact endpoints, scopes, and parameters depend on the provider, so always follow the provider’s OAuth documentation together with the steps above.
To build a per person OAuth flow:
  1. Turn on backend functions: Go to your app dashboard, click Settings, then App settings, and enable backend functions.
  2. Plan the OAuth flow with Discuss mode: Use Discuss mode in the AI chat and describe what you want, for example: “Each person should connect their own LinkedIn account. Help me design the OAuth flow with backend functions.” Work with the AI to outline the redirect, callback, token storage, and token refresh steps based on the provider’s documentation.
  3. Implement the OAuth flow in backend code: Use backend functions (and the plan you created in Discuss mode) to:
    • Send people to the provider’s authorization page.
    • Receive the authorization callback.
    • Store user specific tokens securely in your app’s data.
    • Add token refresh logic if the provider uses expiring tokens.

FAQs

Click on a question below to learn more about connectors.
You can connect your Base44 app to Gmail, Google Workspace tools (Calendar, Drive, Docs, Sheets, Slides), BigQuery, Slack, Notion, Salesforce, HubSpot, LinkedIn, and TikTok, with more tools coming soon.
Yes. You can connect multiple tools to the same app.
Each app uses one account per connector type, for example a single Gmail account for a Gmail connector or a single Slack account for a Slack connector. To connect to a different account, click the More actions icon and choose Switch account.
When you connect a tool, the Required permissions list shows the OAuth scopes and capabilities that your app will be able to use, such as reading or writing data. The connector can only perform actions that match the permissions you approved for that tool in this specific app.To see the exact scopes and permissions for each connector, review the Connector permissions section above.
If you build a flow that requires additional permissions from a connector you already connected, Base44 prompts you to review and approve the updated permissions for that tool before the flow can run.
Any teammate who can edit the app can connect an external tool. Each app uses one connected account per tool. Once connected, all teammates who can edit the app can use the shared connector in that app. People who use your published app interact with data and actions powered by that connector; they do not connect their own accounts.
Yes. You can still create custom integrations and use manual integrations for custom APIs or advanced workflows. Connectors focus on managed, OAuth-based connections to popular tools.
  • Connectors are managed, OAuth-based connections to popular tools that you can set up from the AI chat without handling API keys. They are designed for quick, no-code connections to external tools.
  • Integrations include custom and manual integrations, where you configure API keys and credentials yourself. Use integrations when you need fine-grained control over a specific API or a tool that does not yet have a connector.