Postback integration — Affiliate Portal

Your API key

Send this in the Authorization: Bearer header on every postback. Treat it like a password.

Loading…

Endpoint

POST https://www.ccdebthelp.com/api/affiliates/leads/postback
Content-Type: application/json
Authorization: Bearer dhaf_…

Request body

Field	Type		Notes
`firstName`	string	Required	Lead's first name.
`lastName`	string	Required	Lead's last name.
`email`	string	Required	Lead's email. Used for dedup against your prior submissions.
`phone`	string	Required	10+ digits. Formatting flexible. Used for dedup.
`state`	string	Required	2-letter US state code (e.g. `OH`). Must be a DebtHelp-serviced state.
`debtAmount`	number	Required	Total unsecured debt in USD. Minimum to qualify: $10,000.
`zip`	string	Optional	5-digit ZIP code.
`externalLeadId`	string	Optional	Your internal ID for this lead. Useful for reconciliation.
`subId`	string	Optional	Your sub-affiliate or source identifier.
`campaign`	string	Optional	Campaign / creative identifier.
`custom`	object	Optional	Free-form JSON object preserved for your audit.
`test`	boolean	Optional	If `true`, the lead is stored with status `test` and never counted toward billing. Use this to validate your integration.

Example — curl

curl -X POST 'https://www.ccdebthelp.com/api/affiliates/leads/postback' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "firstName": "Jane",
    "lastName":  "Smith",
    "email":     "jane@example.com",
    "phone":     "(614) 555-0100",
    "state":     "OH",
    "zip":       "43229",
    "debtAmount": 25000,
    "subId":     "src-aug-2026",
    "campaign":  "fb-debt-q3",
    "test":      true
  }'

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
  "lead_id": 12345,
  "status": "qualified",        // or: rejected, duplicate, test
  "qualified": true,
  "reason": "All rules passed",
  "cpl_amount": 35.00,          // null if not qualified
  "received_at": "2026-05-18T20:30:00Z"
}

HTTP code	Meaning
`200`	Accepted. Check `status` + `qualified` in the body.
`400`	Malformed body.
`401`	Missing or invalid `Authorization: Bearer` key.
`403`	Your affiliate account is suspended or rejected.
`429`	Rate limited. Default: 60/min and 1000/hour per affiliate.
`503`	Affiliate portal temporarily offline. Retry with backoff.

Qualification rules

A lead earns CPL only if all of these pass. Otherwise it's stored with status: rejected or duplicate and is not billed.

First + last name present
Valid email
Phone with at least 10 digits
US state present and currently serviced by DebtHelp
Debt amount ≥ $10,000
Email or phone has not appeared in the previous 30 days from any affiliate (dedup)

DebtHelp may adjust these rules. Reach out at affiliates@debthelpcc.com with questions about specific rejection reasons.