Create a Record

post

https://api.talkdeskapp.com/record-lists/{id}/records

Creates a new record in a record list.
Use this endpoint to add a single contact record with phone number and optional metadata.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Scope

record-lists:manage

Path Params

string

required

length between 1 and 36

The identifier of the record list.

Body Params

parameters needed to create a Record

Record object

phone_number

string

required

length between 1 and 20

deprecated

Phone number of the record (required if phone_numbers field is not present)

phone_numbers

array of objects

required

length ≥ 1

List of phone numbers of the record (required if phone_number field is not present)

phone_numbers*

Record phone number

phone_number

string

required

length between 1 and 20

Record phone number

phone_type

string

enum

required

length between 4 and 7

The type of the phone number

Allowed:

first_name

string

required

length between 1 and 80

First name of the record

last_name

string

required

length between 1 and 80

Last name of the record

timezone

string

length between 1 and 35

Timezone of the record

external_provider

string

External_provider of the record

external_id

string

external id of the record

external_url

string

external_url of the record

sync_external_id

boolean

sync_external_id of the record

priority

integer

1 to 10

Priority of the record within the record list

extra_data

object

Extra data of the record

Responses

Language

Credentials

OAuth2

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/hal+json

Scope

201Record created

400Errors were found in the submitted data

401Unauthorized

403Forbidden

404Record List not found