# Session.StartSession(var Integer, Integer [, Text] [, var Record]) Method
> Version: _Available or changed with runtime version 1.0._
Starts a session without a UI and runs the specified codeunit.
## Syntax
```al
[Ok := ]  Session.StartSession(var SessionId: Integer, CodeunitId: Integer [, Company: Text] [, var Record: Record])
```
> NOTE
> This method can be invoked without specifying the data type name.
## Parameters
SessionId
Type: ../integer/integer-data-type
The ID of the new session that is started. The ID is assigned to the SessionID variable after the session is started successfully. This parameter is passed by reference to the method.
CodeunitId
Type: ../integer/integer-data-type
The ID of the codeunit to run when the session is started.
*[Optional] Company*
Type: ../text/text-data-type
The company in which to start the session. By default, the session is started in the same company as the calling session.
*[Optional] Record*
Type: ../record/record-data-type
A record that is passed to the OnRun trigger of the codeunit that runs when the session is started. This parameter is optional.
## Return Value
*[Optional] Ok*
Type: ../boolean/boolean-data-type
true if the operation was successful; otherwise false. If you omit this optional return value and the operation does not execute successfully, a runtime error will occur.
## Remarks
The session is started on the same Business Central instance from which the method is called. The session that is started is a background session and therefore has no UI. The session executes using the same user credentials as the calling AL code.
Each background session has the same impact on resources as a regular user session. In addition, it takes time and resources to start each background session. Therefore, we recommend that you consider when and how you use background sessions. For example, do not use background sessions for small tasks that occur often because the cost of starting the session for each tasks is high.
### Dialog box behavior
The following table describes how dialog boxes are handled in a background or web service session, which has no UI.
Method that creates the dialog box|Behavior
../dialog/dialog-confirm-method|- Dialog box is suppressed.<br />- The following error occurs on the Business Central instance: Business Central attempted to issue a client callback to show a confirmation dialog box.
../dialog/dialog-error-string-joker-method|- Dialog box is suppressed.<br />- AL code execution ends.<br />- The error is logged to the event log of the Business Central instance.<br />- The error is added to the Comments field of the Session Event table.
../dialog/dialog-message-method|- Dialog box is suppressed.<br />- The message is recorded in the event log of the computer that is running Business Central instance. The log entry has type Information and includes the context of the message.
../dialog/dialog-open-method|- Dialog box is suppressed.<br />- Dialog box text is not displayed or logged.
## Example
In this example, the Cache Stress Test codeunit is a custom codeunit.
```al
var
    CacheStressTestRec: Record Customer;
    SessionID: Integer;
    OK: Boolean;
begin
    OK := StartSession(SessionId, CodeUnit::"Cache Stress Test", CompanyName, CacheStressTestRec);
    if OK then
      StopSession(SessionId, 'Logoff cache stress test session')
    else
      Error('The session was not started successfully.');
end;
```
## Related information
session-data-type
Get Started with AL<../../devenv-get-started>
Developing Extensions<../../devenv-dev-overview>

Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/session/session-startsession-integer-integer-string-table-method, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact. https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/session/session-startsession-integer-integer-string-table-method/
