Skip to main content

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.

Base44 provides several ways to connect your app to external APIs. Each approach has different trade-offs around setup complexity, credential management, and flexibility.

Connectors

OAuth login to services like Slack, Google Calendar, or Discord

Custom integrations

Workspace-wide API access via OpenAPI specs

Backend functions

Backend code with full control over requests

​
Connectors

Connectors give you a raw OAuth access token for a third-party service, which you use to call that service’s API directly. Base44 handles the OAuth flow and credential storage. There are two types:
  • Shared connectors: One account is connected for the whole app. All app users share the same token. Best for service accounts, like posting to a company Slack channel or reading from a shared calendar.
  • App user connectors: Each signed-in app user connects their own account. Each user gets their own token. Best for actions that need to happen as the individual user, like sending email from their Gmail account.
const { accessToken } = await base44.asServiceRole.connectors.getConnection(
  "googlecalendar"
);

const response = await fetch(
  "https://www.googleapis.com/calendar/v3/calendars",
  { headers: { Authorization: `Bearer ${accessToken}` } }
);

const calendars = await response.json();

connectors

Complete API reference

​
Custom integrations

Custom integrations let you call external APIs using shared credentials that aren’t specific to a user or app. A workspace administrator imports an OpenAPI specification, configures the credentials, and then any app in the workspace can call that API through the SDK. Requests are proxied through Base44’s backend, so secrets never reach the browser. Once an integration is set up, all apps in the workspace share it. Developers never handle API keys directly, so the admin can rotate credentials without touching app code. 
const response = await base44.integrations.custom.call(
  "my-crm", // integration slug
  "get:/contacts", // endpoint: method:path format
  {
    pathParams: { id: "123" },
    queryParams: { limit: 10 },
  }
);

if (response.success) {
  console.log(response.data);
}

custom integrations

Complete API reference

​
Backend functions

Backend functions run on the server, so you can safely store API keys and secrets as environment variables without exposing them to the browser. Use backend functions when you need full control over API requests, want to add custom logic or data transformation, or are working with APIs that don’t have a custom integration available. Your frontend calls the backend function, which then makes the external API request and returns the result. 
// In your backend function
export default async function handler(request: Request) {
  const apiKey = process.env.EXTERNAL_API_KEY;

  const response = await fetch("https://api.example.com/data", {
    headers: {
      Authorization: `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
  });

  return Response.json(await response.json());
}

functions

Learn more about backend functions