Skip to main content
Integrations module for calling integration methods. This module provides access to integration methods for interacting with external services. Unlike the connectors module that gives you raw OAuth tokens, integrations provide pre-built functions that Base44 executes on your behalf. There are two types of integrations:
  • Built-in integrations (Core): Pre-built functions provided by Base44 for common tasks such as AI-powered text generation, image creation, file uploads, and email. Access core integration methods using: 
    base44.integrations.Core.FunctionName(params)
  • Custom integrations (custom): Pre-configured external APIs. Custom integration calls are proxied through Base44’s backend, so credentials are never exposed to the frontend. Access custom integration methods using: 
    base44.integrations.custom.call(slug, operationId, params)
    To call a custom integration, it must be pre-configured by a workspace administrator who imports an OpenAPI specification.
This module is available to use with a client in all authentication modes:
  • Anonymous or User authentication (base44.integrations): Integration methods are invoked with the current user’s permissions. Anonymous users invoke methods without authentication, while authenticated users invoke methods with their authentication context.
  • Service role authentication (base44.asServiceRole.integrations): Integration methods are invoked with elevated admin-level permissions. The methods execute with admin authentication context.

​
Indexable

[packageName: string]: IntegrationPackage Access to additional integration packages.

​
Type Declarations

​
Core

Core: CoreIntegrations
Core package containing built-in Base44 integration functions.

​
custom

custom: CustomIntegrationsModule
Custom integrations module for calling pre-configured external APIs.

​
CoreIntegrations

Core package containing built-in Base44 integration functions.

​
Methods

​
InvokeLLM()

InvokeLLM(params): Promise<string | object>
Generate text or structured JSON data using AI models.

​
Parameters

​
params
InvokeLLMParams
required
Parameters for the LLM invocation
​
prompt
string
required
The prompt text to send to the model
​
add_context_from_internet
boolean
If set to true, the LLM will use Google Search, Maps, and News to gather real-time context before answering.
​
response_json_schema
object
If you want structured data back, provide a JSON schema object here. If provided, the function returns a JSON object; otherwise, it returns a string.
​
file_urls
string[]
A list of file URLs (uploaded via UploadFile) to provide as context/attachments to the LLM. Do not use this together with add_context_from_internet.

​
Returns

Promise<string | object> Promise resolving to a string (when no schema provided) or an object (when schema provided).

​
Examples

const response = await base44.integrations.Core.InvokeLLM({
  prompt: "Write a haiku about coding."
});

​
GenerateImage()

GenerateImage(params): Promise<GenerateImageResult>
Create AI-generated images from text prompts.

​
Parameters

​
params
GenerateImageParams
required
Parameters for image generation
​
prompt
string
required
Description of the image to generate.

​
Returns

GenerateImageResult URL of the generated image.

​
Example

const {url} = await base44.integrations.Core.GenerateImage({
  prompt: "A serene mountain landscape with a lake in the foreground"
});
console.log(url); // https://...generated_image.png

​
UploadFile()

UploadFile(params): Promise<UploadFileResult>
Upload files to public storage and get a URL.

​
Parameters

​
params
UploadFileParams
required
Parameters for file upload
​
file
File
required
The file object to upload.

​
Returns

UploadFileResult URL of the uploaded file.

​
Example

const handleFileUpload = async (event: React.ChangeEvent<HTMLInputElement>) => {
  const file = event.target.files?.[0];
  if (!file) return;

  const { file_url } = await base44.integrations.Core.UploadFile({ file });
  console.log(file_url); // https://...uploaded_file.pdf
};

​
SendEmail()

SendEmail(params): Promise<any>
Send emails to registered users of your app.

​
Parameters

​
params
SendEmailParams
required
Parameters for sending email
​
to
string
required
Recipient email address.
​
subject
string
required
Email subject line.
​
body
string
required
Plain text email body content.
​
from_name
string
The name of the sender. If omitted, the app’s name will be used.

​
Returns

Promise<any> Promise resolving when the email is sent.

​
ExtractDataFromUploadedFile()

ExtractDataFromUploadedFile(params): Promise<object>
Extract structured data from uploaded files based on the specified schema. Start by uploading the file to public storage using the UploadFile() function. Then, use the file_url parameter to extract structured data from the uploaded file.

​
Parameters

​
params
ExtractDataFromUploadedFileParams
required
Parameters for data extraction
​
file_url
string
required
The URL of the uploaded file to extract data from.
​
json_schema
object
required
A JSON schema object defining what data fields you want to extract.

​
Returns

Promise<object> Promise resolving to the extracted data.

​
Examples

const result = await base44.integrations.Core.ExtractDataFromUploadedFile({
  file_url: "https://example.com/files/invoice.pdf",
  json_schema: {
    type: "object",
    properties: {
      invoice_number: { type: "string" },
      total_amount: { type: "number" },
      date: { type: "string" },
      vendor_name: { type: "string" }
    }
  }
});
console.log(result); // { invoice_number: "INV-12345", total_amount: 1250.00, ... }

​
UploadPrivateFile()

UploadPrivateFile(params): Promise<UploadPrivateFileResult>
Upload files to private storage that requires a signed URL to access. Create a signed URL to access uploaded files using the CreateFileSignedUrl() function.

​
Parameters

​
params
UploadPrivateFileParams
required
Parameters for private file upload
​
file
File
required
The file object to upload.

​
Returns

UploadPrivateFileResult URI of the uploaded private file, used to create a signed URL.

​
Examples

const { file_uri } = await base44.integrations.Core.UploadPrivateFile({ file });
console.log(file_uri); // "private/user123/document.pdf"

​
CreateFileSignedUrl()

CreateFileSignedUrl(params): Promise<CreateFileSignedUrlResult>
Generate temporary access links for private files. Start by uploading the file to private storage using the UploadPrivateFile() function. Then, use the file_uri parameter to create a signed URL to access the uploaded file.

​
Parameters

​
params
CreateFileSignedUrlParams
required
Parameters for creating signed URL
​
file_uri
string
required
URI of the uploaded private file.
​
expires_in
number
How long the signed URL should be valid for, in seconds.

​
Returns

CreateFileSignedUrlResult Temporary signed URL to access the private file.

​
Example

const { signed_url } = await base44.integrations.Core.CreateFileSignedUrl({
  file_uri: "private/user123/document.pdf",
  expires_in: 7200 // URL expires in 2 hours
});
console.log(signed_url); // https://...?signature=...

​
CustomIntegrationsModule

Module for calling custom pre-configured API integrations. Custom integrations allow workspace administrators to connect any external API by importing an OpenAPI specification. Apps in the workspace can then call these integrations using this module.

​
Methods

​
call()

call(slug, operationId, params?): Promise<CustomIntegrationCallResponse>
Call a custom integration endpoint.

​
Parameters

​
slug
string
required
The integration’s unique identifier, as defined by the workspace admin.
​
operationId
string
required
The endpoint in method:path format. For example, "get:/contacts", or "post:/users/{id}". The method is the HTTP verb in lowercase and the path matches the OpenAPI specification.
​
params
CustomIntegrationCallParams
Optional parameters including payload, pathParams, and queryParams.

​
Returns

Promise<CustomIntegrationCallResponse> Promise resolving to the integration call response.

​
Throws

If slug is not provided.

​
Throws

If operationId is not provided.

​
Throws

If the integration or operation is not found (404).

​
Throws

If the external API call fails (502).

​
Throws

If the request times out (504).

​
Examples

const response = await base44.integrations.custom.call(
  "my-crm",
  "get:/contacts",
  { queryParams: { limit: 10 } }
);

if (response.success) {
  console.log("Contacts:", response.data);
}