Quickstart

Set up your shell

Export the key PowerDialer issued you and define the headers every call uses.

export API_KEY="pd_live_..."
BASE=https://api.migration.powerdialer.ai/api/public/v1
AUTH=(-H "Authorization: Bearer $API_KEY" -H "x-user-email: [email protected]")

Create a list with contacts

One call creates the list and seeds it. Contacts go through the same path as a CSV upload, including background enrichment.

curl -X POST "$BASE/contact-lists" "${AUTH[@]}" -H "Content-Type: application/json" \
  -d '{
    "name": "Partner leads October",
    "groupName": "Partner",
    "contacts": [
      { "name": "Ada Lovelace", "phoneNumber": "+15550100" },
      { "name": "Grace Hopper", "phoneNumber": "+15550101", "metadata": { "company": "Acme" } }
    ]
  }'

Response · 201 Created

{
  "id": 4821,
  "name": "Partner leads October",
  "groupName": "Partner",
  "contactsCount": 2,
  "orgId": "org_2xyz...",
  "createdAt": "2026-10-06T12:00:00.000Z",
  "updatedAt": "2026-10-06T12:00:00.000Z"
}

Keep the returned id — every other call uses it. Names are not unique.

Add more contacts later

Batches of up to 10,000, append-only. Numbers already in the list are skipped, not updated.

curl -X POST "$BASE/contact-lists/4821/contacts" "${AUTH[@]}" -H "Content-Type: application/json" \
  -d '{"contacts":[{"name":"Margaret Hamilton","phoneNumber":"+15550102"}]}'

Response · 200 OK

{ "contactListId": 4821, "received": 1, "added": 1, "skippedExisting": 0, "duplicatesInPayload": 0 }

Read the user's analytics

Pass the user’s timezone so day boundaries match what they see in the app.

curl "$BASE/analytics/summary?startDate=2026-10-01&endDate=2026-10-07&timezone=America/New_York" "${AUTH[@]}"

The response includes calls.total, calls.connected, calls.conversations, rates.connectRate and more — see Analytics.

Next steps

Contact lists

Rename, regroup and delete lists.

Contacts

Contact shape, batch semantics, removal by phone.

Errors and limits

Status codes, rate limit, payload caps.

API Reference

Every endpoint with a live playground.

Get started

Guides

Reference

Next steps

Contact lists

Contacts

Errors and limits

API Reference

​Next steps

Contact lists

Contacts

Errors and limits

API Reference

Next steps