Skip to main content
POST
/
v1
/
contact-entries
Create Contact Entries
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

Authorization
string
header
required

Bearer API key issued from Settings → Developers.

Body

application/json

Create Contact Entries payload

items
ContactEntryInput · object[]
required

Contact entries to create.

Required array length: 1 - 100 elements

Response

200 - application/json

Successful Response

items
BatchItemResult[ContactEntryOutput] · object[]
required
summary
BatchSummary · object
required