API Reference
Contacts
Custom Fields
Campaigns
Contact Lists
Suppression Groups
Contacts
Search Contacts by Emails
Searches for multiple contacts by their email addresses in a single request. Returns all matching contacts found in your project.
POST
/
contacts
/
search
/
emails
curl --request POST \
--url https://api.autosend.com/v1/contacts/search/emails \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"emails": [
"[email protected]",
"[email protected]"
]
}'
{
"success": true,
"data": {
"contacts": [
{
"id": "507f1f77bcf86cd799439011",
"email": "[email protected]",
"firstName": "John",
"lastName": "Doe",
"userId": "user_12345",
"customFields": {
"company": "Acme Corp",
"role": "Developer",
"plan": "premium"
},
"updatedAt": "2024-01-15T10:30:00.000Z",
"createdAt": "2024-01-15T10:30:00.000Z",
"projectId": "229f1f77bcf86cd9273048038"
}
]
}
}
Documentation Index
Fetch the complete documentation index at: https://docs.autosend.com/llms.txt
Use this file to discover all available pages before exploring further.
curl --request POST \
--url https://api.autosend.com/v1/contacts/search/emails \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"emails": [
"[email protected]",
"[email protected]"
]
}'
{
"success": true,
"data": {
"contacts": [
{
"id": "507f1f77bcf86cd799439011",
"email": "[email protected]",
"firstName": "John",
"lastName": "Doe",
"userId": "user_12345",
"customFields": {
"company": "Acme Corp",
"role": "Developer",
"plan": "premium"
},
"updatedAt": "2024-01-15T10:30:00.000Z",
"createdAt": "2024-01-15T10:30:00.000Z",
"projectId": "229f1f77bcf86cd9273048038"
}
]
}
}
Authorizations
Bearer authentication header of the form Bearer
<token>, where <token> is your auth token.Body
Array of email addresses to searchArray of email addresses (minimum 1, automatically normalized)Example:
["[email protected]", "[email protected]"]Response
Contacts retrieved successfullyIndicates if the request was successfulExample:
trueShow child attributes
Show child attributes
Array of contact objects
Show child attributes
Show child attributes
Contact IDExample:
"507f1f77bcf86cd799439011"Contact email addressExample:
"[email protected]"Contact’s first nameExample:
"John"Contact’s last nameExample:
"Doe"Your application’s user identifierExample:
"user_12345"Custom contact attributes
Example:
Show child attributes
Show child attributes
{
"company": "Acme Corp",
"role": "Developer",
"plan": "premium"
}
Contact creation timestampExample:
"2024-01-15T10:30:00.000Z"Contact last update timestampExample:
"2024-01-15T10:30:00.000Z"Project ID that the contact belongs toExample:
"229f1f77bcf86cd9273048038"⌘I
curl --request POST \
--url https://api.autosend.com/v1/contacts/search/emails \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"emails": [
"[email protected]",
"[email protected]"
]
}'
{
"success": true,
"data": {
"contacts": [
{
"id": "507f1f77bcf86cd799439011",
"email": "[email protected]",
"firstName": "John",
"lastName": "Doe",
"userId": "user_12345",
"customFields": {
"company": "Acme Corp",
"role": "Developer",
"plan": "premium"
},
"updatedAt": "2024-01-15T10:30:00.000Z",
"createdAt": "2024-01-15T10:30:00.000Z",
"projectId": "229f1f77bcf86cd9273048038"
}
]
}
}