Skip to main content
POST
/
v3
/
contact-lists
Create a contact list
curl --request POST \
  --url https://api.reply.io/v3/contact-lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "isShared": false
}
'
{
  "id": 123,
  "name": "<string>",
  "isShared": true
}

Authorizations

​
Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Body

application/json
​
name
string
required

Contact list name

​
isShared
boolean
default:false

Whether the contact list should be shared

Response

Contact list created successfully

Contact list entity

​
id
integer
read-only

Unique identifier of the contact list

​
name
string

Contact list name

​
isShared
boolean

Whether the contact list is shared across the team