Skip to main content

About integrations

Integrations connect Base44 to the rest of your stack so you can automate workflows, pull in data, and call external services without wiring every API call by hand. You can integrate at 3 levels:
  • App level: Integrations inside a single app:
    • Built-in integrations such as Invoke LLM and SendEmail.
    • Connectors for OAuth-based connections to tools like Notion, Slack, or Google Workspace.
    • External API calls with backend functions that use per-app Secrets and functions.
    • An app MCP server that lets AI assistants like Claude, ChatGPT, and Cursor securely connect to your published app and use its data and actions.
  • Workspace level: Shared APIs managed once for the whole workspace:
    • Custom OpenAPI integrations based on OpenAPI specs that any app in the workspace can call securely.
  • Account level: Connections that live on your Base44 account:
    • MCP connections that you configure once so the Base44 AI chat can use external tools while you build, without changing your app’s deployed code.

App level integrations

App-level integrations live inside a single app. They include built-in integrations, connectors, and backend-powered external APIs that you wire to that app only.

Built-in integrations

Some integrations come preinstalled in Base44 and are available to use immediately. Most work on any plan, with no extra setup or separate API keys. With these core integrations, you can add AI, messaging, file handling, and advanced logic to any app. Base44 built-in integrations include:
  • Invoke LLM: Generate AI responses from detailed prompts, with JSON schema outputs, file attachments, image analysis, and web search.
  • SendEmail: Send emails from your app with your own sender name and HTML content, or send one of your designed emails.
  • SendPushNotification: Send a push notification to one person in your native mobile app, with an optional link to a specific page.
  • UploadPublicFile: Let people upload files that anyone with the link can open, such as profile pictures or product photos, and use the returned file URL in other integrations or workflows.
  • UploadPrivateFile: Store files that hold personal or sensitive details privately, so only your app can open them.
  • CreateFileSignedUrl: Create a temporary link to a private file, so someone can view or download it.
  • GenerateImage: Create images from text prompts, on their own or from reference images you give it.
  • GenerateVideo: Create videos from text prompts.
  • GenerateSpeech: Turn text into spoken audio.
  • TranscribeAudio: Turn recorded speech into text.
  • ExtractDataFromUploadedFile: Pull structured data from uploaded CSV, XLSX, JSON, HTML, PNG, JPG, JPEG, and PDF files using JSON schemas.
Learn more about built-in integrations.

Connectors

Connectors are OAuth-enabled integrations that let a specific app connect to supported tools. You ask the AI chat to connect a service, sign in, and approve the requested permissions. Your app can then read or write data in that tool based on what you allow. Examples of what you can build with connectors:
  • Sync a Notion database to power a knowledge view in your app.
  • Post updates to a Slack channel.
  • Sync Salesforce or HubSpot records into an internal dashboard.
  • Save files from your app to Google Drive.
  • Block off time in Google Calendar when a new booking is made.
  • Publish a LinkedIn post when a new blog post is published.
  • Show TikTok profile stats and follower counts in a dashboard.

External API calls with backend functions

External integrations using backend functions let a specific app talk directly to third-party services like Stripe, Twilio, or Google APIs with per-app credentials. These calls are wired through your own backend functions and Secrets.
Connecting an integration to your app using the AI chat

Connecting an integration to your Base44 app using the AI chat

Use backend functions when:
  • You want a one-off integration for a single app.
  • You need custom logic that is tightly coupled to that app.
  • The service is not yet set up as a custom OpenAPI integration in your workspace.
Examples of external integrations with backend functions:
  • Sending welcome emails to new people using your app via your email provider.
  • Syncing your existing CRM with your app database.
  • Alerting your team in Slack when someone submits a form.
  • Generating content with AI tools using your own provider keys.
  • Calling vendor-specific APIs that do not have a connector or custom OpenAPI integration yet.
  • Letting each person connect their own account on a service that uses OAuth2 sign-in. See Connecting a service with its own sign-in.
When you request an integration in the AI chat, Base44 guides you step by step and asks for credentials or authorization when needed. It then connects the backend and frontend logic automatically so you can get up and running fast. You store credentials as secrets in your app’s dashboard and use them in TypeScript functions under Code > base44 > functions. Learn how to add, change, and delete your app’s secrets.
Each backend function has a code file you can edit, view, and test. To check a function’s logs, open its file in Code and click Logs.

Connecting AI assistants

Your published app can expose its own MCP server so AI assistants can use its data and actions, with access controlled by you. This is different from account-level MCP connections, which the Base44 AI chat uses while you build.

Workspace level integrations

Workspace-level integrations live in a workspace and can be reused across many apps without repeating setup or credentials.

Custom OpenAPI integrations

Custom OpenAPI integrations let you register shared external APIs at the workspace level from an OpenAPI specification. You import a spec once, select the operations you want to expose, and any app in that workspace can call those operations through the SDK. The AI and your frontend code can call custom OpenAPI integrations directly through base44.integrations.custom without exposing credentials. Calls are proxied through the Base44 backend, so secrets never reach the browser. This is ideal for internal APIs and partner APIs that your team uses across many apps.
Who can create and use custom OpenAPI integrations:
  • Plan: You need a Builder plan or higher to create or edit custom OpenAPI integrations.
  • Role: Only workspace owners and admins can create or edit custom OpenAPI integrations.
  • Using one: Anyone in the workspace can use an existing custom OpenAPI integration in their apps, even on a Free plan.
Learn how to configure these APIs in detail in Managing custom API integrations.

Account level connections

Account-level connections are configured once for your Base44 account and are available wherever you use the Base44 AI chat.

MCP connections

MCP connections let you connect custom MCP servers to your Base44 account so the AI chat can use external tools and data as context while you build. This gives you a context-aware AI chat without changing your app’s deployed runtime.
What to know about MCP connections:
  • Plan: You need a Builder plan or higher to use MCP connections.
  • Setup: MCP servers are configured once per account under Account settings → Builder → MCP Connections.
  • When they’re used: The AI chat only calls an MCP server when your prompt requires it (for example, when you mention that server or ask for data it provides). It doesn’t contact every MCP server for every message.
Examples of what you can do with MCP connections:
  • Ask the AI chat to search an internal docs MCP and summarize the most relevant pages for a feature.
  • Connect a GitHub MCP server and ask for a summary of open issues in a specific repo.
  • Connect an analytics MCP, such as Amplitude or a custom metrics service, and ask the chat to pull recent product metrics into the conversation while you plan changes.
Learn how to add and manage MCP servers in Setting up a custom MCP.

Storing API keys

Some integrations need an API key, which acts like a private password between your app and the external service. You create the key in that service, then save it in Base44 so your app can use it without exposing it:
  • App secrets: For backend functions in one app, save the key as an app secret on your app’s Secrets page, or paste it into the AI chat and Base44 saves it for you. See Managing app secrets.
  • Custom OpenAPI integrations: A workspace owner or admin adds the key once as a header when creating or editing the integration, and Base44 stores it encrypted in your workspace. See Managing custom API integrations.

FAQs

Click a question below to learn more about using integrations.
Custom OpenAPI integrations are configured once in a workspace from an OpenAPI spec and are available to every app in that workspace through base44.integrations.custom.call(). Credentials are stored as encrypted workspace secrets and never exposed to app code, and you do not need backend functions to use them.Per-app external APIs use backend functions and Secrets in a specific app. They are ideal for app-specific logic or when you do not want to share an API across all apps in a workspace.
Before publishing your app, test your integration so you can catch issues early:
  1. Use sandbox or test mode (for example, Stripe test keys), if the provider offers it.
  2. Try real flows and edge cases, not just a single happy path.
  3. Check that inputs and outputs match your expectations in your UI and in the provider’s dashboard.
  4. Monitor integration credit usage in both Base44 and the external service.
  5. Preview your app to catch slow loading, failed API calls, or missing data before going live.
If you run into issues, check the following:
  • Your API key is correct and saved in Secrets or in the custom OpenAPI integration, if relevant.
  • You have enough active credits in the external service.
  • You are using live credentials, not test ones, when testing production flows.
  • Your API request includes the correct endpoint, payload, and parameters.
  • You have not hit the service’s rate limits.
Workspace owners and admins can create backend functions in apps they own. Collaborators with an Editor role can also edit and create backend functions in an app.
If you see a 403 error when using backend functions, the request is usually missing permissions.Common causes and fixes:
  • Permissions in your function: Your backend function may be rejecting the request because the person is not signed in or does not have the right role. Check any role or access checks you added in the function code.
  • External service permissions: A 403 can also come from the external API you are calling. Make sure the API key has the right scopes and that the request uses the correct endpoint and method.
  • Still having trouble: See the backend function fixes in Base44 developer tools, or contact Customer Care.
There are 2 types of API keys you may need to regenerate or update:
  • Third-party service keys: Regenerate your key in that service’s developer portal, for example OpenAI, Resend, Notion, then change the secret’s value in your app’s dashboard or update it in your custom OpenAPI integration settings.
  • Your Base44 account API key: Account API keys are no longer supported, and you can’t regenerate one. Existing keys are being switched off gradually, so create a personal access token instead and update anything that used the old key.
  • Built-in integrations, connectors, and per-app external APIs that use backend functions remain available.
  • Custom OpenAPI integrations and MCP connections may stop working until you upgrade to a Builder plan or higher.
Base44 doesn’t send text messages (SMS) itself. To send them from your app, sign up with an SMS service, save its API key as a secret, and ask the AI chat to send messages through a backend function. For example:
Yes. You can mix built-in integrations, connectors, custom OpenAPI integrations, and per-app external APIs in the same app, as long as your plan and settings support them.
For security reasons, external services like Stripe, OpenAI, or Notion do not let third parties, including Base44, access your credentials automatically. Instead, you need to:
  1. Log in to the service.
  2. Go to the API or developer section.
  3. Generate your key.
  4. Paste it into Base44 as a Secret or workspace header.
Once added, your app or custom OpenAPI integration can use that key behind the scenes safely and without code.
Why this matters: API keys act like passwords for services. Keeping them private and under your control keeps your data safe and ensures only you authorize access.
No. MCP connections are only for the Base44 AI chat while you build. You set them up once for your account, under MCP Connections in your account settings, and the AI chat uses them only when your prompt requires that MCP server. Your deployed app does not call MCP servers through this settings page.
Still need help? Join our Discord and get real-time support from the Base44 team and community.