curl --request POST \
--url https://app.mlm-platform.com/api/v1/leads/capture \
--header 'Content-Type: application/json' \
--header 'x-tenant-api-key: <api-key>' \
--data '
{
"email": "lead@example.com"
}
'{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"email": "jsmith@example.com",
"name": "<string>",
"referrer_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"conversion_status": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}Core APIs
Capture a lead
Captures a lead with optional referral attribution. Leads can be converted to members later using the member creation endpoint.
POST
/
api
/
v1
/
leads
/
capture
curl --request POST \
--url https://app.mlm-platform.com/api/v1/leads/capture \
--header 'Content-Type: application/json' \
--header 'x-tenant-api-key: <api-key>' \
--data '
{
"email": "lead@example.com"
}
'{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"email": "jsmith@example.com",
"name": "<string>",
"referrer_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"conversion_status": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}Authorizations
Tenant API key for authentication. Keys are scoped to specific environments (LIVE or SANDBOX). Obtain keys from the admin dashboard.
Body
application/json
Lead email address (normalized to lowercase)
Optional display name for the lead
Maximum string length:
255Optional phone number for the lead
Referral code for attribution
Lead source (e.g., "landing_page", "social")
Maximum string length:
100UTM source
UTM medium
UTM campaign
Response
Lead captured successfully