post https://api.talkdeskapp.com/record-lists
And signed URL for the CSV file
Scope
record-lists:manage
Request Body (required)
{
"name": "RecordList 20",
"csv_metadata": {
"filename": "recordList.csv",
"byte_size": 413,
"checksum": "d2c07dcf1589304317056dd7e28e32b8",
"content_type": "text/csv"
}
}
Body Response - Schema
201 (created record list and signed URL for the csv file
| Parameter | Type | Description | Required |
|---|---|---|---|
| id | string | ID of the csv file | no |
| name | string | name of the csv file to be uploaded | no |
| unique_identifier_type | string | Duplicate checking logic configured for the record list: PHONE_NUMBER - duplicate checking based on the record's phone_number. EXTERNAL -duplicate checking based on the record's external_id and external_provider. NOTHING - no duplicate checking. | no |
| status | string | status of the csv file | no |
| signed_url | string | URL to save the csv file in S3 | no |
| _links | object | "_links" subdivides into: 1 - "self" (object) 1.1 - "href" (string) | no |
400 (errors were found in the submitted data), 401 (unauthorized), 403 (forbidden), 413 (payload too large)
| Parameter | Type | Description | Required |
|---|---|---|---|
| code | string | n/a | no |
| message | string | n/a | no |
| description | string | n/a | no |
| fields | array[object] | "fields" subdivides into: "name" (string) "description" (string) | yes (name and description) |
Troubleshooting
If 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.