Skip to main content
POST
Create a list

Authorizations

Authorization
string
header
required

Authorization: Bearer <api key>. The key is issued by PowerDialer and must stay on your server.

Headers

x-user-email
string<email>

Login email of the PowerDialer user the request acts for. Send this or x-user-id; if both are sent, x-user-id wins.

x-user-id
string

Clerk user id of the PowerDialer user the request acts for. Send this or x-user-email.

Example:

"user_2abc..."

Body

application/json
name
string
required
Required string length: 1 - 150
Example:

"Partner leads October"

groupName
string | null

Optional folder-style grouping.

Maximum string length: 100
Example:

"Partner"

contacts
object[]

Optional. Omit for an empty list.

Required array length: 1 - 10000 elements

Response

Created

id
integer
required
Example:

4821

name
string
required
Example:

"Partner leads October"

groupName
string | null
required
Example:

"Partner"

contactsCount
integer
required
Example:

2

orgId
string
required
Example:

"org_2xyz..."

createdAt
string<date-time>
required
updatedAt
string<date-time>
required
duplicatesInPayload
integer

Present only when the create payload repeated a phone number.