Batch Create Account Entries
Add entries to existing account lists in batch (up to 100 items per request).
Unlike single-resource POST endpoints, the body wraps the payloads in
items and the response reports a per-item status. Each item is looked up
in the Topo lead database by domain and its company profile is completed
from the match; an item whose company is not found is reported as
FAILED with NOT_IN_LEAD_DATABASE. An item whose account is already in
the list is reported as ALREADY_MEMBER with the existing entry and counts
as succeeded.
Requires the account_lists:write scope on the API key.
curl --request POST \
--url https://api.topo.io/v1/account-entries \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"account_list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"domain": "<string>"
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
account_list_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
name: '<string>',
domain: '<string>'
}
]
})
};
fetch('https://api.topo.io/v1/account-entries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.topo.io/v1/account-entries"
payload = { "items": [
{
"account_list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"domain": "<string>"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"items": [
{
"index": 123,
"status": "CREATED",
"resource": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"domain": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"error": {
"type": "<string>",
"message": "<string>"
}
}
],
"summary": {
"total": 123,
"succeeded": 123,
"failed": 123
}
}Authorizations
Bearer API key issued from Settings → Developers.
Body
Batch Create Account Entries payload
Response
Successful Response
Hide child attributes
Hide child attributes
CREATED, UPDATED, ALREADY_MEMBER, FAILED Hide child attributes
Hide child attributes
Unique identifier.
ID of the list this entry belongs to.
ID of the account this entry belongs to. Always set on entries created through this API; null only on older entries that were never matched to an account.
Company name.
Primary company domain.
When the entry was created.
When the entry last changed.
Was this page helpful?
curl --request POST \
--url https://api.topo.io/v1/account-entries \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"items": [
{
"account_list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"domain": "<string>"
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
account_list_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
name: '<string>',
domain: '<string>'
}
]
})
};
fetch('https://api.topo.io/v1/account-entries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.topo.io/v1/account-entries"
payload = { "items": [
{
"account_list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"domain": "<string>"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"items": [
{
"index": 123,
"status": "CREATED",
"resource": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"domain": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"error": {
"type": "<string>",
"message": "<string>"
}
}
],
"summary": {
"total": 123,
"succeeded": 123,
"failed": 123
}
}