Skip to main content
createClient(config): Base44Client
Creates a Base44 client. This is the main entry point for the Base44 SDK. It creates a client that provides access to the SDK’s modules, such as entities, auth, and functions. How you get a client depends on your context:
  • Inside a Base44 app: The client is automatically created and configured for you. Import it from @/api/base44Client.
  • External app using Base44 as a backend: Call createClient() directly in your code to create and configure the client.
The client supports three authentication modes:
  • Anonymous: Access modules without authentication using base44.moduleName. Operations are scoped to public data and permissions.
  • User authentication: Access modules with user-level permissions using base44.moduleName. Operations are scoped to the authenticated user’s data and permissions. Use base44.auth.loginViaEmailPassword() or other auth methods to get a token.
  • Service role authentication: Access modules with elevated permissions using base44.asServiceRole.moduleName. Operations can access any data available to the app’s admin. Only available in Base44-hosted backend functions. Create a client with service role authentication using createClientFromRequest().
For example, when using the entities module:
  • Anonymous: Can only read public data.
  • User authentication: Can access the current user’s data.
  • Service role authentication: Can access all data that admins can access.
Most modules are available in all three modes, but with different permission levels. However, some modules are only available in specific authentication modes.

​
Parameters

​
config
CreateClientConfig
required
Configuration object for the client.
​
appId
string
required
The Base44 app ID.You can find the appId in the browser URL when you’re in the app editor. It’s the string between /apps/ and /editor/.
​
token
string
User authentication token. Used to authenticate as a specific user.Inside Base44 apps, the token is managed automatically. For external apps, use auth methods like loginViaEmailPassword() which set the token automatically.
​
options
CreateClientOptions
Additional client options.
​
onError
(error: Error) => void
Optional error handler that will be called whenever an API error occurs.

​
Returns

Base44Client The Base44 client instance. Provides access to all SDK modules for interacting with the app. A configured Base44 client instance with access to all SDK modules.
​
agents
AgentsModule
required
Agents module for managing AI agent conversations.
​
analytics
AnalyticsModule
required
Analytics module for tracking custom events in your app.
​
appLogs
AppLogsModule
required
App logs module for tracking app usage.
​
auth
AuthModule
required
Auth module for user authentication and management.
​
entities
EntitiesModule
required
Entities module for CRUD operations on your data models.
​
functions
FunctionsModule
required
Functions module for invoking custom backend functions.
​
integrations
IntegrationsModule
required
Integrations module for calling pre-built integration endpoints.
​
cleanup
() => void
required
Cleanup function to disconnect WebSocket connections. Call when you’re done with the client.
​
asServiceRole
object
required
Provides access to supported modules with elevated permissions.Service role authentication provides elevated permissions for backend operations. Unlike user authentication, which is scoped to a specific user’s permissions, service role authentication has access to the data and operations available to the app’s admin.
​
agents
AgentsModule
required
Agents module with elevated permissions.
​
appLogs
AppLogsModule
required
App logs module with elevated permissions.
​
connectors
ConnectorsModule
required
Connectors module for OAuth token retrieval.
​
entities
EntitiesModule
required
Entities module with elevated permissions.
​
functions
FunctionsModule
required
Functions module with elevated permissions.
​
integrations
IntegrationsModule
required
Integrations module with elevated permissions.
​
cleanup
() => void
required
Cleanup function to disconnect WebSocket connections.

​
Example

import { createClient } from "@base44/sdk";

const base44 = createClient({
  appId: "my-app-id",
});

// Use the client to access your data
const products = await base44.entities.Products.list();