Skip to main content
POST
Add contacts (batch)

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..."

Path Parameters

id
integer
required

Id of the contact list, from the create response.

Example:

4821

Body

application/json
contacts
object[]
required
Required array length: 1 - 10000 elements

Response

Batch result

contactListId
integer
required
Example:

4821

received
integer
required

Contacts in the request.

Example:

3

added
integer
required
Example:

2

skippedExisting
integer
required

Numbers already in the list; not updated.

Example:

1

duplicatesInPayload
integer
required

Repeated numbers inside the request, collapsed to the first.

Example:

0