curl --request GET \
--url https://api.reply.io/v3/email-accounts/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.reply.io/v3/email-accounts/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.reply.io/v3/email-accounts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.reply.io/v3/email-accounts/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.reply.io/v3/email-accounts/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.reply.io/v3/email-accounts/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.reply.io/v3/email-accounts/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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"
]
}Get an email account
channels:read scope (or a broader one that includes it).
Get one email account in full: connection, safety, signature, opt-out and ramp-up settings, tags, and connection status.
curl --request GET \
--url https://api.reply.io/v3/email-accounts/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.reply.io/v3/email-accounts/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.reply.io/v3/email-accounts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.reply.io/v3/email-accounts/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.reply.io/v3/email-accounts/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.reply.io/v3/email-accounts/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.reply.io/v3/email-accounts/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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
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
Email Account ID
Response
Email account details
Full detailed representation of an email account, including all configuration sections.
Unique identifier for the email account
ID of the user who owns this email account
Provider type of the email account. Values: custom, gmail, outlook, exchange, exchangeOnPremise
custom, gmail, outlook, exchange, exchangeOnPremise Whether this is the user's default email account
Whether this email account is currently used in any active sequence
Current connection status of the email account. Values: unknown, connected, disconnected
unknown, connected, disconnected Error details if SMTP sending connectivity has failed
Error details if IMAP receiving connectivity has failed
Whether the email provider has locked outbound sending
Timestamp of the last update to this email account
Connection settings returned in responses (passwords excluded).
Show child attributes
Show child attributes
Sending safety and throttling configuration.
Show child attributes
Show child attributes
Email signature configuration.
Show child attributes
Show child attributes
Opt-out / unsubscribe link configuration.
Show child attributes
Show child attributes
Sending volume ramp-up configuration for warming up email accounts.
Show child attributes
Show child attributes
Tag names associated with this email account