Skip to main content
GET
/
email-accounts
/
{id}
Get an email account
curl --request GET \
  --url https://api.reply.io/v3/email-accounts/{id} \
  --header 'X-API-Key: <api-key>'
{
  "id": 12345,
  "userId": 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"
  ]
}

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header

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>
required

Unique identifier for the email account

emailAccountType
string
required

Provider type of the email account (e.g., Gmail, Exchange, Custom)

connectionStatus
string
required

Current connection status of the email account

userId
integer

ID of the user who owns this email account

isDefault
boolean

Whether this is the user's default email account

isInUse
boolean

Whether this email account is currently used in any active sequence

sendingConnectivityError
string | null

Error details if SMTP sending connectivity has failed

receivingConnectivityError
string | null

Error details if IMAP receiving connectivity has failed

sendingLockedByProvider
boolean

Whether the email provider has locked outbound sending

updatedAt
string<date-time>

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