PATCH
/
v4
/
email-accounts
/
{id}
Update an email account
curl --request PATCH \
  --url https://api.reply.io/v4/email-accounts/{id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "safety": {
    "dailyLimit": 750
  },
  "signature": {
    "signature": "Updated signature"
  }
}
'
{
  "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

Path Parameters

id
integer<int64>
required

Email Account ID

Body

application/json

Request body for partially updating an email account (PATCH). Only provide the sections and fields you want to change. Omitted sections and fields are left unchanged.

connection
EmailAccountConnectionSection · object

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 (replaces existing tags)

Response

Email account updated 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