In the record list
Scope
record-lists:manage
Request Body (required)
{
"records": [
{
"phone_numbers": [
{
"phone_number": "+351929312319",
"phone_type": "MOBILE"
}
],
"first_name": "Joey",
"last_name": "Tribbiani",
"timezone": "Europe/Lisbon",
"priority": 7,
"extra_data": {
"country": "USA",
"state": "California",
"job": "Actor"
}
},
{
"phone_numbers": [
{
"phone_number": "+351929312318",
"phone_type": "MOBILE"
}
],
"first_name": "Jane",
"last_name": "Doe",
"timezone": "GMT",
"priority": 5,
"extra_data": {
"country": "USA",
"state": "California",
"job": "Actress"
}
}
]
}Records Body Parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
| phone_number | string | Phone number of the record.
| deprecated |
| phone_numbers | array[object] | List of phone numbers of the record.
"phone_numbers" subdivides into: 1 - "phone_number" (string) - record phone number.
2 - "phone_type" (string) - The type of the phone number
| yes |
| first_name | string | First name of the record.
| yes |
| last_name | string | Last name of the record.
| yes |
| timezone | string | Timezone of the record.
| no |
| external_provider | string | external_provider of the record | no |
| external_id | string | external ID of the record | no |
| external_url | string | external_url of the record | no |
| sync_external_id | boolean | sync_external_id of the record | no |
| priority | integer | Priority of the record within the record list.
| no |
| extra_data | object | _ | no |
Body Response - Schema
201 (records created)
| Parameter | Type | Description | Required |
|---|---|---|---|
| record_list_id | string | Record list ID.
| no |
| has_error | 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 (errors found in the submitted data), 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.