Bulk update a list of records in the record list
Supported Regions and Base URLs
Access and RegistrationAuthentication
Scope
record-lists:manage
Request Body
[
{
"op": "replace",
"path": "/records/{record_id}",
"value": {
"extra_data": {
"home": "earth"
},
"priority": 10
}
},
{
"op": "add",
"path": "/records/{record_id}",
"value": {
"extra_data": {
"name": "jerry"
}
}
}
]Body Response - Schema
200 (records updated successfully)
| Parameter | Type | Description | Required |
|---|---|---|---|
| record_list_id | string | Record list ID.
| no |
| has_errors | boolean | true if records upload has errors | no |
| total_errors | integer | Total number of errors found in the multiple records upload.
| no |
| total_created | integer | Total number of records created in multiple records upload request.
| no |
| _links | object | "_links" subdivides into: 1 - "self" (object). Required. 2 - "record_list" (object). Required. | no |
| _embedded | object | List of records resulted from insertion. "_embedded" subdivides into: 1 - "records" (array[object]) - array of records. 1.1 - "id" (string) - record ID. 1.2 - "record_list_id" (string) - record list ID. 1.3 - "phone_number" (string) - phone number of the record. Deprecated. 1.4 - "phone_numbers" (array[object]) - list of phone numbers of the record.
1.5 - "first_name" (string) - first name of the record. 1.6 - "last_name" (string) - last name of the record. 1.7 - "timezone" (string) - timezone of the record. 1.8 - "priority" (integer) - priority of the record within the record list.
1.9 - "extra_data" (object) - extra data of the record. 1.10 - "external_provider" (string) - reference for external provider source. 1.11 - "external_id" (string) - unique identifier for resource in external source. 1.12 - "external_url" (string) - resource location in external source. 1.13 - "sync_external_id" (boolean) - sync external ID with contacts. 1.14 - "errors" ( 1.15 - "created_at" (string) - record creation date. 1.16 - "updated_at" (string) - record update date. 1.17 - "_links" (string) - record update date. | no |
400 (bad request), 401 (unauthorized), 403 (forbidden), 404 (record list not found)
| Parameter | Type | Description | Required |
|---|---|---|---|
| code | string | n/a | yes |
| message | string | n/a | yes |
| description | string | n/a | no |
| fields | array[object] | "fields" subdivides into: "name" (string) "description" (string) | yes (name and description) |
TroubleshootingIf you have any questions regarding the usage of this API, or if you’re having any technical issues, please open a ticket using this form.
Body ResponseThe parameters from the body response are part of an array.