Skip to main content
GET
/
v3
/
email-accounts
/
{id}
Get an email account
curl --request GET \
  --url https://api.reply.io/v3/email-accounts/{id} \
  --header 'Authorization: Bearer <token>'
{
  "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"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.reply.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Path Parameters

id
integer<int64>
required

Email Account ID

Response

Email account details

Full detailed representation of an email account, including all configuration sections.

id
integer<int64>
read-only

Unique identifier for the email account

ownerUserId
integer
read-only

ID of the user who owns this email account

emailAccountType
enum<string>
read-only

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

Available options:
custom,
gmail,
outlook,
exchange,
exchangeOnPremise
isDefault
boolean
read-only

Whether this is the user's default email account

isInUse
boolean
read-only

Whether this email account is currently used in any active sequence

connectionStatus
enum<string>
read-only

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

Available options:
unknown,
connected,
disconnected
sendingConnectivityError
string | null
read-only

Error details if SMTP sending connectivity has failed

receivingConnectivityError
string | null
read-only

Error details if IMAP receiving connectivity has failed

sendingLockedByProvider
boolean
read-only

Whether the email provider has locked outbound sending

updatedAt
string<date-time>
read-only

Timestamp of the last update to this email account

connection
EmailAccountConnectionResponseSection · object

Connection settings returned in responses (passwords excluded).

safety
EmailAccountSafetySection · object

Sending safety and throttling configuration.

signature
EmailAccountSignatureSection · object

Email signature configuration.

optOut
EmailAccountOptOutSection · object

Opt-out / unsubscribe link configuration.

rampUp
EmailAccountRampUpSection · object

Sending volume ramp-up configuration for warming up email accounts.

tags
string[]

Tag names associated with this email account