Skip to main content
PATCH
/
v3
/
email-accounts
/
{id}
Update an email account
curl --request PATCH \
  --url https://api.reply.io/v3/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
enum<string>

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

Available options:
custom,
gmail,
outlook,
exchange,
exchangeOnPremise
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
enum<string>

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

Available options:
unknown,
connected,
disconnected
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