Endpoints
Create Lead
Create a new consumer/lead when a borrower is declined due to credit issues
POST
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
string
required
Borrower’s first name
string
required
Borrower’s last name
string
required
Borrower’s email address (must be valid format)
string
required
Borrower’s phone number (digits, hyphens, spaces, or + allowed)
string
Your internal ID for this borrower. Recommended for tracking and webhook correlation.
string
FICO score range. Examples:
"500-549", "550-579", "580-619", "620-659"string
Identifier for the loan officer handling this borrower
string
Additional notes about the decline reason or borrower situation
Response
boolean
true if the lead was created successfullystring
Status message
integer
Credzu’s unique identifier for this lead. Store this value - it’s used for all subsequent API calls and webhook callbacks.
string
Echo of your partner_lead_id if provided
What Happens Next
After successfully creating a lead:- Credzu sends a
lead_receivedwebhook to your registered endpoint - The borrower receives onboarding communications from Credzu
- As the borrower progresses, you receive webhook events for each milestone
- When the borrower becomes mortgage-ready, you receive the
mortgage_readyevent
Store the returned
lead_id - you’ll need it to look up lead status or correlate webhook events.