POST
/
v4
/
email-accounts
Create an email account
curl --request POST \
  --url https://api.reply.io/v4/email-accounts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "connection": {
    "email": "sales@company.com",
    "senderName": "Sales Team",
    "smtpHost": "smtp.company.com",
    "smtpPort": 465,
    "smtpPassword": "secret123",
    "smtpSsl": true,
    "imapHost": "imap.company.com",
    "imapPort": 993,
    "imapPassword": "secret123",
    "imapSsl": true
  },
  "safety": {
    "dailyLimit": 500
  },
  "signature": {
    "signature": "Best regards,\nSales Team"
  },
  "optOut": {
    "isOptOutLinkEnabled": true,
    "optOutTextBlock": "Unsubscribe here"
  },
  "rampUp": {
    "enabled": false,
    "startValue": 10,
    "incrementValue": 5
  },
  "tags": [
    "Outbound"
  ]
}
'
{
  "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"
  ]
}

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header

Body

application/json

Request body for creating a new custom email account (SMTP/IMAP).

connection
EmailAccountConnectionSection · object
required

SMTP and IMAP connection settings for a custom email account. Only applicable to Custom provider type.

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 to assign to the new email account

Response

Email account created successfully

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

id
integer<int64>

Unique identifier for the email account

ownerUserId
integer

ID of the user who owns this email account

emailAccountType
string

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

isDefault
boolean

Whether this is the user's default email account

isInUse
boolean

Whether this email account is currently used in any active sequence

connectionStatus
string

Current connection status of the email account

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