Skip to main content
POST
/
email-accounts
/
filter
Filter email accounts
curl --request POST \
  --url https://api.reply.io/v3/email-accounts/filter \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "status": "connected",
  "emailAccountType": "Gmail",
  "domains": [
    "company.com"
  ],
  "tags": [
    "Marketing"
  ]
}
'
{
  "items": [
    {
      "id": 12345,
      "userId": 42,
      "email": "john.doe@company.com",
      "senderName": "John Doe",
      "emailAccountType": "Gmail",
      "isDefault": true,
      "dailyLimit": 500,
      "connectionStatus": "connected",
      "tags": [
        "Marketing",
        "Outbound"
      ]
    }
  ],
  "hasMore": true
}

Authorizations

X-API-Key
string
header
required

API key passed in the X-API-Key header

Query Parameters

top
integer

Maximum number of items to return (default 25, max 1000)

skip
integer

Number of items to skip

Body

application/json

Filter criteria for searching email accounts.

status
string | null

Filter by connection status

emailAccountType
string | null

Filter by email account provider type (e.g., Gmail, Exchange, Custom)

email
string | null

Filter by email address (partial match)

domains
string[] | null

Filter by email domains

userIds
integer[] | null

Filter by owner user IDs

tags
string[] | null

Filter by tag names

Response

Paginated list of matching email accounts

items
EmailAccountListItem · object[]
hasMore
boolean

Whether more items are available beyond the current page