---
id: object/page/4511
type: object
title: Page 4511 "SMTP Account Wizard"
summary: Page 4511 "SMTP Account Wizard" in Email - SMTP Connector (System.Email). 1 public procedures. Introduced in BC29, still in BC30.
tier: official
language: en
tags:
  - page
  - email - smtp connector
versions:
  introduced: "29"
  last_changed: null
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: aca697a886db83d979e5339d7a76e4df0df1253958722d01fa8e135c075c4862
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Apps/W1/Email%20-%20SMTP%20Connector/app/src/SMTPAccountWizard.Page.al
    title: src/Apps/W1/Email - SMTP Connector/app/src/SMTPAccountWizard.Page.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-extending-email
    title: Extending Email
    date: null
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-extending-email
  objects: []
  features: []
  topics:
    - topic/dev-itpro/development/extensibility/extending-the-base-application/examples
  localizations: []
  videos: []
  posts: []
  guidelines: []
object_type: page
object_id: 4511
name: SMTP Account Wizard
caption: Set up SMTP Account
namespace: System.Email
app: Email - SMTP Connector
extends: null
first_version: "29"
last_version: "30"
present_in:
  - "29"
  - "30"
changed_in: []
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids:
  - docs/learn-devitpro/dev-itpro/developer/devenv-extending-email.md
counts:
  fields: 0
  procedures: 10
  events: 0
  subscribers: 0
  controls: 18
  actions: 4
relations:
  out: 1
  referenced_by: 0
  pages: 0
  extended_by: 0
  event_subscribers: 0
  calls: 3
  called_by: 0
  implements: 0
---

# Page 4511 "SMTP Account Wizard"

> Page 4511 "SMTP Account Wizard" in Email - SMTP Connector (System.Email). 1 public procedures. Introduced in BC29, still in BC30.

Email - SMTP Connector · System.Email · captioned "Set up SMTP Account" · BC29-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Apps/W1/Email%20-%20SMTP%20Connector/app/src/SMTPAccountWizard.Page.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| Caption | Set up SMTP Account |
| Extensible | false |
| SourceTable | SMTP Account |
| PageType | NavigatePage |
| Permissions | tabledata "SMTP Account" = rimd |

## Fields on this page

Layout controls in source order, grouped by the container they sit in. Shows: the table field a control is bound to (or its expression as written); ToolTip: the control's own, else the bound field's (marked).

| Group | Control | Shows | ToolTip |
|---|---|---|---|
| TopBanner | NotDoneIcon | `MediaResources."Media Reference"` |  |
| Setup | Account Name | [Name](../table/4511.md#fields) | Specifies the name of the SMTP account |
|  | Sender Type | [Sender Type](../table/4511.md#fields) | Specifies if a specific sender or the current user is used as sender. If the current user is used, it must be ensured that the account is allowed to send on behalf of the user. |
|  | Sender Name | [Sender Name](../table/4511.md#fields) | Specifies a name to add in front of the sender email address. For example, if you enter Stan in this field, and the email address is stan@cronus.com, the recipient will see the sender as Stan stan@cronus.com. |
|  | Email Address | [Email Address](../table/4511.md#fields) | Specifies the Email Address specified as the from email address. |
|  | ServerUrl | [Server](../table/4511.md#fields) | Specifies the address of the SMTP server. For example, smtp.office365.com. <small>from the table field</small> |
|  | Server Port | [Server Port](../table/4511.md#fields) | Specifies the port of the SMTP server. The default setting is 25. |
|  | Authentication | [Authentication Type](../table/4511.md#fields) | Specifies the type of authentication that the SMTP mail server uses. |
| CheckIfCustomOAuth | Use custom app registration | `CustomOAuth` | Specifies if you want to set up a custom app registration for OAuth 2.0 authentication. |
| Step3Basic | User Name | [User Name](../table/4511.md#fields) | Specifies the username to use when authenticating with the SMTP server. |
|  | Secure Connection | [Secure Connection](../table/4511.md#fields) | Specifies if your SMTP mail server setup requires a secure connection that uses a cryptography or security protocol, such as secure socket layers (SSL). Clear the check box if you do not want to enable this security setting. |
| PasswordGroup | Password | `Password` | Specifies the password of the SMTP server. |
| Azure Application registration | Client Id | `ClienStorageIdText` | Specifies the Client Id. |
|  | Client Secret | `ClientSecretStorageIdText` | Specifies the Client Secret. |
|  | Tenant ID | `TenantId` | Specifies the Tenant ID. |
| RedirectUriGroup | Redirect URI | [Redirect Uri](../table/4511.md#fields) | Specifies the redirect URI configured in the app registration in Microsoft Entra (Azure AD). This is required for OnPrem deployments. |
| HyperLinks | Doc | `AppRegistrationsLbl` |  |
|  | Doc2 | `AppPermissionsLbl` |  |

## Actions

| Group | Action | ToolTip | Runs |
|---|---|---|---|
| Processing | Authenticate OAuth <small>obsolete Pending 28.0; #if not CLEAN28</small> | Setup OAuth 2.0 authentication. The user will be prompted to sign in to their account and grant admin permissions to the application. |  |
|  | Apply Office 365 Server Settings | Apply the Office 365 server settings to this record. |  |
|  | Back | Back |  |
|  | Next | Next |  |

## Procedures

- `GetAccount(var EmailAccount: Record "Email Account"): Boolean` (internal)

Plus 9 local procedures.

## Triggers

OnOpenPage

## Relations

- source table [Table 4511 "SMTP Account"](../table/4511.md)

## Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an `Object::"Name"` argument. Interface dispatch and calls through events are not counted, so the list is not complete.

- [Codeunit 4513 "SMTP Connector Impl."](../codeunit/4513.md) (2 calls: `EnsureAccountCreated → CreateAccount`, `SetProperties → GetO365SmtpServer`)
- [Codeunit 457 "Environment Information"](../codeunit/457.md) (2 calls: `OnOpenPage → IsOnPrem`, `SetProperties → IsSaaSInfrastructure`)
- [Codeunit 4516 "OAuth2 SMTP Authentication"](../codeunit/4516.md) (1 call: `AuthenticateWithOAuth2CustomAppReg → AuthenticateWithOAuth2CustomAppReg`)

## Across versions

- Present in: BC29-30
- Changed (declaration) in: none

## Documented on Microsoft Learn

- [Extending Email](https://learn.microsoft.com/dynamics365/business-central/dev-itpro/developer/devenv-extending-email)

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: `bcatlas_resolve_node(object_type: "page", object_name: "SMTP Account Wizard")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.