Bulk Contacts by Id
You are viewing legacy documentation. These APIs are maintained for partners with existing implementations. New projects should use v2.
View the current GraphQL API Reference → | View the current REST API Reference →
POST/contacts/bulk/id
The bulk endpoints offer an efficient way of importing/updating large amounts of contacts with just a single API call. When using the bulk id endpoint, the contacts are identified by id. If a contact doesn't already exist, it will be created. If it does exist, the contact found will be updated.
Contact bulk endpoints support bulk change of contact attributes for multiple contacts as well. To learn more about Attributes, go here.
Contact bulk endpoints support bulk change of pricing for multiple contacts as well. To learn more about Pricing, go here.
A single contact attributes can be modified as explained in Bulk resource attribute values by resource lookup key, but if it's needed to modify attributes for multiple contacts, this endpoint should be used.
Fields
| Name | Required |
|---|---|
contacts (array of contact objects) | yes |
id | yes |
debtorId (deprecated) | no |
firstName | no |
middleName | no |
lastName | no |
abbreviation | no |
title | no |
dateOfBirth | no |
gender | no |
ssn | no |
phone | no |
email | no |
parent | no |
pricelistAmount | no |
pricelistPercentage | no |
primaryLanguage | no |
sourceId | no |
source | only when sourceId is provided |
attributes Read more about attributes | no |
pricing Read more about pricing | no |
Request
Responses
- 200
- 400
Bulk Contacts by Id - 200
Response Headers
Bulk Contacts by Id - 400 (invalid schema)