Create Contact Entries
Add one or more entries to existing contact lists.
Requires the contact_lists:write scope on the API key.
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
contact_list_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
first_name: '<string>',
last_name: '<string>',
email: '<string>',
linkedin_url: '<string>',
company_name: '<string>',
company_domain: '<string>',
job_title: '<string>',
phone: '<string>'
}
]
})
};
fetch('https://api.topo.io/v1/contact-entries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"index": 123,
"resource": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"contact_list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"linkedin_url": "<string>",
"company_name": "<string>",
"company_domain": "<string>",
"job_title": "<string>",
"phone": "<string>",
"description": "<string>",
"location": "<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
Create Contact Entries payload
Contact entries to create.
1 - 100 elementsHide child attributes
Hide child attributes
ID of the contact list to add this entry to.
First name.
Last name.
Email. At least one of email or linkedin_url is required.
LinkedIn profile URL. At least one of email or linkedin_url is required.
Employer name.
Employer's primary domain.
Job title.
Phone number.
Response
Successful Response
Hide child attributes
Hide child attributes
CREATED, UPDATED, FAILED Hide child attributes
Hide child attributes
Unique identifier.
ID of the list this entry belongs to.
ID of the contact this entry resolved to, once matched.
First name.
Last name.
Email.
LinkedIn URL.
Employer name.
Employer domain.
Job title.
Phone number.
Free-form notes.
Person's location.
When the entry was created.
When the entry last changed.
Was this page helpful?
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
items: [
{
contact_list_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
first_name: '<string>',
last_name: '<string>',
email: '<string>',
linkedin_url: '<string>',
company_name: '<string>',
company_domain: '<string>',
job_title: '<string>',
phone: '<string>'
}
]
})
};
fetch('https://api.topo.io/v1/contact-entries', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"items": [
{
"index": 123,
"resource": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"contact_list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"first_name": "<string>",
"last_name": "<string>",
"email": "<string>",
"linkedin_url": "<string>",
"company_name": "<string>",
"company_domain": "<string>",
"job_title": "<string>",
"phone": "<string>",
"description": "<string>",
"location": "<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
}
}