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.
Requires the account_lists:write scope on the API key.
POST
/
v1
/
account-entries
Batch Create Account Entries
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,
"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
application/json
Batch Create Account Entries payload
Response
200 - application/json
Successful Response
Hide child attributes
Hide child attributes
Available options:
CREATED, UPDATED, FAILED Hide child attributes
Hide child attributes
Unique identifier.
ID of the list this entry belongs to.
ID of the account this entry resolved to, once matched.
Company name.
Primary company domain.
When the entry was created.
When the entry last changed.
Was this page helpful?
⌘I
Batch Create Account Entries
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,
"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
}
}