Quickstart

1. Store your API key

Create or request a key with the leads:read scope, then export it in your shell.

export DIALDOZER_API_KEY='ddz_live_replace_me'

Never commit the key. Use your platform secret store in production.

2. Retrieve a lead

curl -G 'https://app.dialdozer.com/hooks/api_v1.php' \
  --data-urlencode 'r=leads/42' \
  -H "X-Api-Key: $DIALDOZER_API_KEY" \
  -H 'Accept: application/json'

{
  "ok": true,
  "lead": {
    "lead_id": 42,
    "first_name": "Alice",
    "last_name": "Johnson",
    "phone": "15551234567",
    "email": "alice@example.com",
    "status": "NEW",
    "campaign": "OUTBOUND"
  }
}

3. Use a tool

Connect an agent using the MCP setup guide, or inspect the same resource from the terminal:

dialdozer leads get 42 --json

4. Handle failures

Treat non-2xx responses as failures and branch on the stable error value. See errors and rate limits.