Account

Update account info

Updates account information<br/><br/>Credentials are not verified while handling this request. The account connects afterwards, and an authentication failure surfaces as an authenticationError state rather than an error here. Use the account verification endpoint to test credentials up front.

put/v1/account/{account}

Request

  • Base URL: https://your-emailengine-host
  • URL: https://your-emailengine-host/v1/account/{account}
  • Auth: HTTP bearer

Path parameters

accountstring required

Unique identifier for the email account

Example:user123

Headers

x-ee-timeoutinteger

Request timeout in milliseconds. Raises the command timeout above the EENGINE_TIMEOUT default for a long-running request; a value below the default has no effect

Example:30000

Request body

namestring

Display name for the account

emailstring

Default email address of the account

expectedEmailstring nullable

Pins the account to an email address. Set to null to remove the constraint

pathstring[] nullable

Mailbox folders to monitor for changes (IMAP only). Use "*" to monitor all folders (default)

subconnectionsstring[]

Additional mailbox paths to monitor with dedicated IMAP connections for faster change detection. Use sparingly as connection limits are strict.

webhooksstring

Account-specific webhook URL

copyboolean nullable

Copy submitted messages to Sent folder. Set to null to unset and use provider specific default.

logsboolean

Store recent logs

notifyFromstring date-time nullable

Only send webhooks for messages received after this date. Defaults to account creation time. IMAP only.

proxystring

Proxy for this account, used instead of the instance-wide proxy: its IMAP and SMTP connections and, for an OAuth2 account, its token requests and Gmail API or MS Graph API calls

smtpEhloNamestring nullable

Hostname to use in SMTP EHLO/HELO commands (defaults to system hostname)

localestring

Optional locale

tzstring

Optional timezone

Example request

{
  "name": "Nyan Cat",
  "email": "nyan.cat@example.com",
  "imap": {
    "partial": true,
    "disabled": true
  },
  "smtp": {
    "partial": true,
    "host": "mail.example.com"
  }
}

Response

Returns the account ID. Changed credentials take effect on the next connection.

accountstring required

Unique identifier for the email account

Example response

{
  "account": "user123"
}

Changes

No recorded changes to this operation across all 1 revision of this API.