Skip to main content
POST
https://credzu.com/wp-json/credzu/v1
/
create-lead
curl -X POST https://credzu.com/wp-json/credzu/v1/create-lead \
  -H "Content-Type: application/json" \
  -H "Authorization: Credzu-Key YOUR_API_KEY" \
  -d '{
    "partner_lead_id": "FBHL-55672",
    "first_name": "John",
    "last_name": "Smith",
    "email": "[email protected]",
    "phone": "555-333-2222",
    "fico_range": "580-619",
    "loan_officer_id": "A.GLADSTONE",
    "notes": "Declined for credit reasons - 48% DTI, low mid-score"
  }'

{
  "success": true,
  "message": "Lead created",
  "lead_id": 44921,
  "partner_lead_id": "FBHL-55672"
}

​
Overview

Creates a new consumer inside Credzu when a borrower is declined due to credit issues. This is the primary endpoint for referring declined loan applicants to Credzu’s credit repair workflow.

​
Request Body

​
first_name
string
required
Borrower’s first name
​
last_name
string
required
Borrower’s last name
​
email
string
required
Borrower’s email address (must be valid format)
​
phone
string
required
Borrower’s phone number (digits, hyphens, spaces, or + allowed)
​
partner_lead_id
string
Your internal ID for this borrower. Recommended for tracking and webhook correlation.
​
fico_range
string
FICO score range. Examples: "500-549", "550-579", "580-619", "620-659"
​
loan_officer_id
string
Identifier for the loan officer handling this borrower
​
notes
string
Additional notes about the decline reason or borrower situation

​
Response

​
success
boolean
true if the lead was created successfully
​
message
string
Status message
​
lead_id
integer
Credzu’s unique identifier for this lead. Store this value - it’s used for all subsequent API calls and webhook callbacks.
​
partner_lead_id
string
Echo of your partner_lead_id if provided
curl -X POST https://credzu.com/wp-json/credzu/v1/create-lead \
  -H "Content-Type: application/json" \
  -H "Authorization: Credzu-Key YOUR_API_KEY" \
  -d '{
    "partner_lead_id": "FBHL-55672",
    "first_name": "John",
    "last_name": "Smith",
    "email": "[email protected]",
    "phone": "555-333-2222",
    "fico_range": "580-619",
    "loan_officer_id": "A.GLADSTONE",
    "notes": "Declined for credit reasons - 48% DTI, low mid-score"
  }'

{
  "success": true,
  "message": "Lead created",
  "lead_id": 44921,
  "partner_lead_id": "FBHL-55672"
}

​
What Happens Next

After successfully creating a lead:
  1. Credzu sends a lead_received webhook to your registered endpoint
  2. The borrower receives onboarding communications from Credzu
  3. As the borrower progresses, you receive webhook events for each milestone
  4. When the borrower becomes mortgage-ready, you receive the mortgage_ready event
Store the returned lead_id - you’ll need it to look up lead status or correlate webhook events.