Sign in

v1

latestOpenAPI 3.1.02026-07-26359254.7 MB
Email Accounts

Get an email account

<small>Requires the channels:read scope (or a broader one that includes it).</small>

Returns the full details of a single email account including all configuration sections.

get/v3/email-accounts/{id}

Path parameters

idinteger required

Email Account ID

Response

Email account details

idinteger

Unique identifier for the email account

ownerUserIdinteger

ID of the user who owns this email account

emailAccountType'custom' | 'gmail' | 'outlook' | 'exchange' | 'exchangeOnPremise'

Provider type of the email account. Values: custom, gmail, outlook, exchange, exchangeOnPremise

isDefaultboolean

Whether this is the user's default email account

isInUseboolean

Whether this email account is currently used in any active sequence

connectionStatus'unknown' | 'connected' | 'disconnected'

Current connection status of the email account. Values: unknown, connected, disconnected

sendingConnectivityErrorstring nullable

Error details if SMTP sending connectivity has failed

receivingConnectivityErrorstring nullable

Error details if IMAP receiving connectivity has failed

sendingLockedByProviderboolean

Whether the email provider has locked outbound sending

updatedAtstring date-time

Timestamp of the last update to this email account

tagsstring[]

Tag names associated with this email account

Example response

{
  "id": 12345,
  "ownerUserId": 42,
  "emailAccountType": "custom",
  "isDefault": false,
  "isInUse": true,
  "connectionStatus": "connected",
  "sendingConnectivityError": null,
  "receivingConnectivityError": null,
  "sendingLockedByProvider": false,
  "updatedAt": "2026-03-15T10:30:00Z",
  "connection": {
    "email": "john.doe@company.com",
    "senderName": "John Doe",
    "smtpHost": "smtp.company.com",
    "smtpPort": 465,
    "smtpSsl": true,
    "imapHost": "imap.company.com",
    "imapPort": 993,
    "imapSsl": true
  },
  "safety": {
    "dailyLimit": 500,
    "isEmailsThrottlingEnabled": true,
    "emailsPerInterval": 5,
    "emailsThrottlingSecondsInterval": 60,
    "isSendingDelayEnabled": true,
    "maxSendingDelaySeconds": 120,
    "minSendingDelaySeconds": 30
  },
  "signature": {
    "signature": "Best regards,\nJohn Doe"
  },
  "optOut": {
    "message": "Unsubscribe",
    "emailFooter": "",
    "isOptOutLinkEnabled": true,
    "optOutTextBlock": "Click here to unsubscribe"
  },
  "rampUp": {
    "enabled": false,
    "startValue": 10,
    "incrementValue": 5
  },
  "tags": [
    "Marketing"
  ]
}