> ## 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.

# createClientFromRequest

***

> **createClientFromRequest**(`request`): `Base44Client`

Creates a Base44 client from an HTTP request.

This function is designed for use in Base44-hosted backend functions. For frontends and external backends, use [`createClient()`](createClient) instead.

When used in a Base44-hosted backend function, `createClientFromRequest()` automatically extracts authentication tokens from the request headers that Base44 injects when forwarding requests. The returned client includes service role access using `base44.asServiceRole`, which bypasses entity access rules and field-level security.

To learn more about the Base44 client, see [`createClient()`](createClient).

## Parameters

**request** `Request` *required*

The incoming HTTP request object containing Base44 authentication headers.

## Returns

`Base44Client`

A configured Base44 client instance with authentication from the incoming request.

> [accordion] Properties
>
> **agents** `AgentsModule` *required*
>
> [Agents module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/agents.md) for managing AI agent conversations.
>
> **aiGateway** `AiGatewayModule` *required*
>
> [AI Gateway module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/ai-gateway.md) for connecting to the Base44 AI Gateway with your own SDK.
>
> **analytics** `AnalyticsModule` *required*
>
> [Analytics module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/analytics.md) for tracking custom events in your app.
>
> **appLogs** `AppLogsModule` *required*
>
> [App logs module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/app-logs.md) for tracking app usage.
>
> **app** `AppModule` *required*
>
> [App module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/app.md) for reading the app's own public configuration.
>
> **actors** `ActorsModule` *required*
>
> [Actors module](https://docs.base44.com/hu/developers/references/sdk/docs/type-aliases/actors.md) for connecting to actor sessions and exchanging messages with actors.
>
> **auth** `AuthModule` *required*
>
> [Auth module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/auth.md) for user authentication and management.
>
> **connectors** `UserConnectorsModule` *required*
>
> [Connectors module](https://docs.base44.com/developers/references/sdk/docs/interfaces/connectors.md#app-user-connectors) for app-user OAuth flows.
>
> **entities** `EntitiesModule` *required*
>
> [Entities module](https://docs.base44.com/hu/developers/references/sdk/docs/type-aliases/entities.md) for CRUD operations on your data models.
>
> **functions** `FunctionsModule` *required*
>
> [Functions module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/functions.md) for invoking custom backend functions.
>
> **integrations** `IntegrationsModule` *required*
>
> [Integrations module](https://docs.base44.com/hu/developers/references/sdk/docs/type-aliases/integrations.md) for calling pre-built integration endpoints.
>
> **payments** `PaymentsModule` *required*
>
> [Payments module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/payments.md) for checkouts and purchases.
>
> **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 bypasses entity access rules and field-level security entirely, giving full read and write access to all of the app's data.
>
> > [accordion] Properties
> >
> > **actors** `ServiceRoleActorsModule` *required*
> >
> > [Actors module](https://docs.base44.com/hu/developers/references/sdk/docs/type-aliases/actors.md) for calling methods on actor sessions as the app's server code.
> >
> > **agents** `AgentsModule` *required*
> >
> > [Agents module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/agents.md) with elevated permissions.
> >
> > **aiGateway** `AiGatewayModule` *required*
> >
> > [AI Gateway module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/ai-gateway.md) with the service-role token.
> >
> > **appLogs** `AppLogsModule` *required*
> >
> > [App logs module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/app-logs.md) with elevated permissions.
> >
> > **browser** `BrowserModule` *required*
> >
> > [Browser module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/browser.md) for remote browser sessions.
> >
> > **connectors** `ConnectorsModule` *required*
> >
> > [Connectors module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/connectors.md) for OAuth token retrieval.
> >
> > **entities** `EntitiesModule` *required*
> >
> > [Entities module](https://docs.base44.com/hu/developers/references/sdk/docs/type-aliases/entities.md) with elevated permissions.
> >
> > **functions** `FunctionsModule` *required*
> >
> > [Functions module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/functions.md) with elevated permissions.
> >
> > **integrations** `IntegrationsModule` *required*
> >
> > [Integrations module](https://docs.base44.com/hu/developers/references/sdk/docs/type-aliases/integrations.md) with elevated permissions.
> >
> > **payments** `ServiceRolePaymentsModule` *required*
> >
> > [Payments module](https://docs.base44.com/developers/references/sdk/docs/interfaces/payments.md#service-role-methods) for creating checkouts, refunds, and subscription changes.
> >
> > **sso** `SsoModule` *required*
> >
> > [SSO module](https://docs.base44.com/hu/developers/references/sdk/docs/interfaces/sso.md) for generating SSO tokens.
> >
> > **cleanup** `() =\> void` *required*
> >
> > Cleanup function to disconnect WebSocket connections.

#### Examples

```typescript User authentication in backend function theme={null}
import { createClientFromRequest } from 'npm:@base44/sdk';

Deno.serve(async (req) => {
  try {
    const base44 = createClientFromRequest(req);
    const user = await base44.auth.me();

    if (!user) {
      return Response.json({ error: 'Unauthorized' }, { status: 401 });
    }

    // Access user's data
    const userOrders = await base44.entities.Orders.filter({ userId: user.id });
    return Response.json({ orders: userOrders });
  } catch (error) {
    return Response.json({ error: error.message }, { status: 500 });
  }
});
```

```typescript Service role authentication in backend function theme={null}
import { createClientFromRequest } from 'npm:@base44/sdk';

Deno.serve(async (req) => {
  try {
    const base44 = createClientFromRequest(req);

    // Read across all users, bypassing the Orders entity's access rules
    const recentOrders = await base44.asServiceRole.entities.Orders.list('-created_at', 50);

    return Response.json({ orders: recentOrders });
  } catch (error) {
    return Response.json({ error: error.message }, { status: 500 });
  }
});
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.