Submit a lead (referral)
curl --request POST \
--url https://www.fundor.io/api/v1/leads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"externalRef": "vai-lead-90311",
"athleteMemberId": "0b6f…",
"contact": {
"firstName": "Casey",
"lastName": "Customer",
"email": "casey@example.com",
"phone": "(555) 300-1234",
"city": "Austin",
"state": "TX",
"zip": "78701"
},
"services": {
"internet": {
"hasProvider": true,
"provider": "Spectrum",
"monthlyPayment": "80"
}
},
"fundraising": {
"commissionSplit": "donate",
"commitmentAccepted": true,
"commitmentVersion": "kickback-commitment-customer-2026-10"
},
"consent": {
"given": true,
"version": "fundor-referral-customer-2026-10",
"token": "cst_9fK2…",
"consentedAt": "2026-11-12T18:04:11Z",
"ip": "203.0.113.7",
"userAgent": "Mozilla/5.0 (iPhone) VAI/3.2",
"phone": "5553001234",
"recordId": "vai-consent-90311"
}
}
'import requests
url = "https://www.fundor.io/api/v1/leads"
payload = {
"externalRef": "vai-lead-90311",
"athleteMemberId": "0b6f…",
"contact": {
"firstName": "Casey",
"lastName": "Customer",
"email": "casey@example.com",
"phone": "(555) 300-1234",
"city": "Austin",
"state": "TX",
"zip": "78701"
},
"services": { "internet": {
"hasProvider": True,
"provider": "Spectrum",
"monthlyPayment": "80"
} },
"fundraising": {
"commissionSplit": "donate",
"commitmentAccepted": True,
"commitmentVersion": "kickback-commitment-customer-2026-10"
},
"consent": {
"given": True,
"version": "fundor-referral-customer-2026-10",
"token": "cst_9fK2…",
"consentedAt": "2026-11-12T18:04:11Z",
"ip": "203.0.113.7",
"userAgent": "Mozilla/5.0 (iPhone) VAI/3.2",
"phone": "5553001234",
"recordId": "vai-consent-90311"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
externalRef: 'vai-lead-90311',
athleteMemberId: '0b6f…',
contact: {
firstName: 'Casey',
lastName: 'Customer',
email: 'casey@example.com',
phone: '(555) 300-1234',
city: 'Austin',
state: 'TX',
zip: '78701'
},
services: {internet: {hasProvider: true, provider: 'Spectrum', monthlyPayment: '80'}},
fundraising: {
commissionSplit: 'donate',
commitmentAccepted: true,
commitmentVersion: 'kickback-commitment-customer-2026-10'
},
consent: {
given: true,
version: 'fundor-referral-customer-2026-10',
token: 'cst_9fK2…',
consentedAt: '2026-11-12T18:04:11Z',
ip: '203.0.113.7',
userAgent: 'Mozilla/5.0 (iPhone) VAI/3.2',
phone: '5553001234',
recordId: 'vai-consent-90311'
}
})
};
fetch('https://www.fundor.io/api/v1/leads', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.fundor.io/api/v1/leads",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'externalRef' => 'vai-lead-90311',
'athleteMemberId' => '0b6f…',
'contact' => [
'firstName' => 'Casey',
'lastName' => 'Customer',
'email' => 'casey@example.com',
'phone' => '(555) 300-1234',
'city' => 'Austin',
'state' => 'TX',
'zip' => '78701'
],
'services' => [
'internet' => [
'hasProvider' => true,
'provider' => 'Spectrum',
'monthlyPayment' => '80'
]
],
'fundraising' => [
'commissionSplit' => 'donate',
'commitmentAccepted' => true,
'commitmentVersion' => 'kickback-commitment-customer-2026-10'
],
'consent' => [
'given' => true,
'version' => 'fundor-referral-customer-2026-10',
'token' => 'cst_9fK2…',
'consentedAt' => '2026-11-12T18:04:11Z',
'ip' => '203.0.113.7',
'userAgent' => 'Mozilla/5.0 (iPhone) VAI/3.2',
'phone' => '5553001234',
'recordId' => 'vai-consent-90311'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://www.fundor.io/api/v1/leads"
payload := strings.NewReader("{\n \"externalRef\": \"vai-lead-90311\",\n \"athleteMemberId\": \"0b6f…\",\n \"contact\": {\n \"firstName\": \"Casey\",\n \"lastName\": \"Customer\",\n \"email\": \"casey@example.com\",\n \"phone\": \"(555) 300-1234\",\n \"city\": \"Austin\",\n \"state\": \"TX\",\n \"zip\": \"78701\"\n },\n \"services\": {\n \"internet\": {\n \"hasProvider\": true,\n \"provider\": \"Spectrum\",\n \"monthlyPayment\": \"80\"\n }\n },\n \"fundraising\": {\n \"commissionSplit\": \"donate\",\n \"commitmentAccepted\": true,\n \"commitmentVersion\": \"kickback-commitment-customer-2026-10\"\n },\n \"consent\": {\n \"given\": true,\n \"version\": \"fundor-referral-customer-2026-10\",\n \"token\": \"cst_9fK2…\",\n \"consentedAt\": \"2026-11-12T18:04:11Z\",\n \"ip\": \"203.0.113.7\",\n \"userAgent\": \"Mozilla/5.0 (iPhone) VAI/3.2\",\n \"phone\": \"5553001234\",\n \"recordId\": \"vai-consent-90311\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://www.fundor.io/api/v1/leads")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"externalRef\": \"vai-lead-90311\",\n \"athleteMemberId\": \"0b6f…\",\n \"contact\": {\n \"firstName\": \"Casey\",\n \"lastName\": \"Customer\",\n \"email\": \"casey@example.com\",\n \"phone\": \"(555) 300-1234\",\n \"city\": \"Austin\",\n \"state\": \"TX\",\n \"zip\": \"78701\"\n },\n \"services\": {\n \"internet\": {\n \"hasProvider\": true,\n \"provider\": \"Spectrum\",\n \"monthlyPayment\": \"80\"\n }\n },\n \"fundraising\": {\n \"commissionSplit\": \"donate\",\n \"commitmentAccepted\": true,\n \"commitmentVersion\": \"kickback-commitment-customer-2026-10\"\n },\n \"consent\": {\n \"given\": true,\n \"version\": \"fundor-referral-customer-2026-10\",\n \"token\": \"cst_9fK2…\",\n \"consentedAt\": \"2026-11-12T18:04:11Z\",\n \"ip\": \"203.0.113.7\",\n \"userAgent\": \"Mozilla/5.0 (iPhone) VAI/3.2\",\n \"phone\": \"5553001234\",\n \"recordId\": \"vai-consent-90311\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.fundor.io/api/v1/leads")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"externalRef\": \"vai-lead-90311\",\n \"athleteMemberId\": \"0b6f…\",\n \"contact\": {\n \"firstName\": \"Casey\",\n \"lastName\": \"Customer\",\n \"email\": \"casey@example.com\",\n \"phone\": \"(555) 300-1234\",\n \"city\": \"Austin\",\n \"state\": \"TX\",\n \"zip\": \"78701\"\n },\n \"services\": {\n \"internet\": {\n \"hasProvider\": true,\n \"provider\": \"Spectrum\",\n \"monthlyPayment\": \"80\"\n }\n },\n \"fundraising\": {\n \"commissionSplit\": \"donate\",\n \"commitmentAccepted\": true,\n \"commitmentVersion\": \"kickback-commitment-customer-2026-10\"\n },\n \"consent\": {\n \"given\": true,\n \"version\": \"fundor-referral-customer-2026-10\",\n \"token\": \"cst_9fK2…\",\n \"consentedAt\": \"2026-11-12T18:04:11Z\",\n \"ip\": \"203.0.113.7\",\n \"userAgent\": \"Mozilla/5.0 (iPhone) VAI/3.2\",\n \"phone\": \"5553001234\",\n \"recordId\": \"vai-consent-90311\"\n }\n}"
response = http.request(request)
puts response.read_body{
"leadId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"externalRef": "<string>",
"projects": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "<string>"
}
],
"duplicate": true,
"deliveryStatus": "queued"
}{
"error": {
"code": "consent_required",
"message": "consent.ip is required. Fundor will reject the lead without it.",
"field": "consent.ip"
}
}{
"error": {
"code": "consent_required",
"message": "consent.ip is required. Fundor will reject the lead without it.",
"field": "consent.ip"
}
}{
"error": {
"code": "consent_required",
"message": "consent.ip is required. Fundor will reject the lead without it.",
"field": "consent.ip"
}
}{
"error": {
"code": "consent_required",
"message": "consent.ip is required. Fundor will reject the lead without it.",
"field": "consent.ip"
}
}{
"error": {
"code": "consent_required",
"message": "consent.ip is required. Fundor will reject the lead without it.",
"field": "consent.ip"
}
}{
"error": {
"code": "consent_required",
"message": "consent.ip is required. Fundor will reject the lead without it.",
"field": "consent.ip"
}
}Leads
Submit a lead (referral)
Creates the customer and one project per selected service, credited to the athlete, and queues it for Fundor’s call center.
Consent is mandatory. Every consent field is checked; if any is missing, stale, reused or wrong, the response is 400 and nothing is saved. The athlete must be one you created or whose owner approved your link. Requires the leads scope.
POST
/
leads
Submit a lead (referral)
curl --request POST \
--url https://www.fundor.io/api/v1/leads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"externalRef": "vai-lead-90311",
"athleteMemberId": "0b6f…",
"contact": {
"firstName": "Casey",
"lastName": "Customer",
"email": "casey@example.com",
"phone": "(555) 300-1234",
"city": "Austin",
"state": "TX",
"zip": "78701"
},
"services": {
"internet": {
"hasProvider": true,
"provider": "Spectrum",
"monthlyPayment": "80"
}
},
"fundraising": {
"commissionSplit": "donate",
"commitmentAccepted": true,
"commitmentVersion": "kickback-commitment-customer-2026-10"
},
"consent": {
"given": true,
"version": "fundor-referral-customer-2026-10",
"token": "cst_9fK2…",
"consentedAt": "2026-11-12T18:04:11Z",
"ip": "203.0.113.7",
"userAgent": "Mozilla/5.0 (iPhone) VAI/3.2",
"phone": "5553001234",
"recordId": "vai-consent-90311"
}
}
'import requests
url = "https://www.fundor.io/api/v1/leads"
payload = {
"externalRef": "vai-lead-90311",
"athleteMemberId": "0b6f…",
"contact": {
"firstName": "Casey",
"lastName": "Customer",
"email": "casey@example.com",
"phone": "(555) 300-1234",
"city": "Austin",
"state": "TX",
"zip": "78701"
},
"services": { "internet": {
"hasProvider": True,
"provider": "Spectrum",
"monthlyPayment": "80"
} },
"fundraising": {
"commissionSplit": "donate",
"commitmentAccepted": True,
"commitmentVersion": "kickback-commitment-customer-2026-10"
},
"consent": {
"given": True,
"version": "fundor-referral-customer-2026-10",
"token": "cst_9fK2…",
"consentedAt": "2026-11-12T18:04:11Z",
"ip": "203.0.113.7",
"userAgent": "Mozilla/5.0 (iPhone) VAI/3.2",
"phone": "5553001234",
"recordId": "vai-consent-90311"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
externalRef: 'vai-lead-90311',
athleteMemberId: '0b6f…',
contact: {
firstName: 'Casey',
lastName: 'Customer',
email: 'casey@example.com',
phone: '(555) 300-1234',
city: 'Austin',
state: 'TX',
zip: '78701'
},
services: {internet: {hasProvider: true, provider: 'Spectrum', monthlyPayment: '80'}},
fundraising: {
commissionSplit: 'donate',
commitmentAccepted: true,
commitmentVersion: 'kickback-commitment-customer-2026-10'
},
consent: {
given: true,
version: 'fundor-referral-customer-2026-10',
token: 'cst_9fK2…',
consentedAt: '2026-11-12T18:04:11Z',
ip: '203.0.113.7',
userAgent: 'Mozilla/5.0 (iPhone) VAI/3.2',
phone: '5553001234',
recordId: 'vai-consent-90311'
}
})
};
fetch('https://www.fundor.io/api/v1/leads', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.fundor.io/api/v1/leads",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'externalRef' => 'vai-lead-90311',
'athleteMemberId' => '0b6f…',
'contact' => [
'firstName' => 'Casey',
'lastName' => 'Customer',
'email' => 'casey@example.com',
'phone' => '(555) 300-1234',
'city' => 'Austin',
'state' => 'TX',
'zip' => '78701'
],
'services' => [
'internet' => [
'hasProvider' => true,
'provider' => 'Spectrum',
'monthlyPayment' => '80'
]
],
'fundraising' => [
'commissionSplit' => 'donate',
'commitmentAccepted' => true,
'commitmentVersion' => 'kickback-commitment-customer-2026-10'
],
'consent' => [
'given' => true,
'version' => 'fundor-referral-customer-2026-10',
'token' => 'cst_9fK2…',
'consentedAt' => '2026-11-12T18:04:11Z',
'ip' => '203.0.113.7',
'userAgent' => 'Mozilla/5.0 (iPhone) VAI/3.2',
'phone' => '5553001234',
'recordId' => 'vai-consent-90311'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://www.fundor.io/api/v1/leads"
payload := strings.NewReader("{\n \"externalRef\": \"vai-lead-90311\",\n \"athleteMemberId\": \"0b6f…\",\n \"contact\": {\n \"firstName\": \"Casey\",\n \"lastName\": \"Customer\",\n \"email\": \"casey@example.com\",\n \"phone\": \"(555) 300-1234\",\n \"city\": \"Austin\",\n \"state\": \"TX\",\n \"zip\": \"78701\"\n },\n \"services\": {\n \"internet\": {\n \"hasProvider\": true,\n \"provider\": \"Spectrum\",\n \"monthlyPayment\": \"80\"\n }\n },\n \"fundraising\": {\n \"commissionSplit\": \"donate\",\n \"commitmentAccepted\": true,\n \"commitmentVersion\": \"kickback-commitment-customer-2026-10\"\n },\n \"consent\": {\n \"given\": true,\n \"version\": \"fundor-referral-customer-2026-10\",\n \"token\": \"cst_9fK2…\",\n \"consentedAt\": \"2026-11-12T18:04:11Z\",\n \"ip\": \"203.0.113.7\",\n \"userAgent\": \"Mozilla/5.0 (iPhone) VAI/3.2\",\n \"phone\": \"5553001234\",\n \"recordId\": \"vai-consent-90311\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://www.fundor.io/api/v1/leads")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"externalRef\": \"vai-lead-90311\",\n \"athleteMemberId\": \"0b6f…\",\n \"contact\": {\n \"firstName\": \"Casey\",\n \"lastName\": \"Customer\",\n \"email\": \"casey@example.com\",\n \"phone\": \"(555) 300-1234\",\n \"city\": \"Austin\",\n \"state\": \"TX\",\n \"zip\": \"78701\"\n },\n \"services\": {\n \"internet\": {\n \"hasProvider\": true,\n \"provider\": \"Spectrum\",\n \"monthlyPayment\": \"80\"\n }\n },\n \"fundraising\": {\n \"commissionSplit\": \"donate\",\n \"commitmentAccepted\": true,\n \"commitmentVersion\": \"kickback-commitment-customer-2026-10\"\n },\n \"consent\": {\n \"given\": true,\n \"version\": \"fundor-referral-customer-2026-10\",\n \"token\": \"cst_9fK2…\",\n \"consentedAt\": \"2026-11-12T18:04:11Z\",\n \"ip\": \"203.0.113.7\",\n \"userAgent\": \"Mozilla/5.0 (iPhone) VAI/3.2\",\n \"phone\": \"5553001234\",\n \"recordId\": \"vai-consent-90311\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.fundor.io/api/v1/leads")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"externalRef\": \"vai-lead-90311\",\n \"athleteMemberId\": \"0b6f…\",\n \"contact\": {\n \"firstName\": \"Casey\",\n \"lastName\": \"Customer\",\n \"email\": \"casey@example.com\",\n \"phone\": \"(555) 300-1234\",\n \"city\": \"Austin\",\n \"state\": \"TX\",\n \"zip\": \"78701\"\n },\n \"services\": {\n \"internet\": {\n \"hasProvider\": true,\n \"provider\": \"Spectrum\",\n \"monthlyPayment\": \"80\"\n }\n },\n \"fundraising\": {\n \"commissionSplit\": \"donate\",\n \"commitmentAccepted\": true,\n \"commitmentVersion\": \"kickback-commitment-customer-2026-10\"\n },\n \"consent\": {\n \"given\": true,\n \"version\": \"fundor-referral-customer-2026-10\",\n \"token\": \"cst_9fK2…\",\n \"consentedAt\": \"2026-11-12T18:04:11Z\",\n \"ip\": \"203.0.113.7\",\n \"userAgent\": \"Mozilla/5.0 (iPhone) VAI/3.2\",\n \"phone\": \"5553001234\",\n \"recordId\": \"vai-consent-90311\"\n }\n}"
response = http.request(request)
puts response.read_body{
"leadId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"externalRef": "<string>",
"projects": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "<string>"
}
],
"duplicate": true,
"deliveryStatus": "queued"
}{
"error": {
"code": "consent_required",
"message": "consent.ip is required. Fundor will reject the lead without it.",
"field": "consent.ip"
}
}{
"error": {
"code": "consent_required",
"message": "consent.ip is required. Fundor will reject the lead without it.",
"field": "consent.ip"
}
}{
"error": {
"code": "consent_required",
"message": "consent.ip is required. Fundor will reject the lead without it.",
"field": "consent.ip"
}
}{
"error": {
"code": "consent_required",
"message": "consent.ip is required. Fundor will reject the lead without it.",
"field": "consent.ip"
}
}{
"error": {
"code": "consent_required",
"message": "consent.ip is required. Fundor will reject the lead without it.",
"field": "consent.ip"
}
}{
"error": {
"code": "consent_required",
"message": "consent.ip is required. Fundor will reject the lead without it.",
"field": "consent.ip"
}
}Authorizations
Your partner API key, sent as Authorization: Bearer fnd_live_…. Keys are issued by Fundor on request. Keep them on your server; never ship one in a mobile or browser app.
Body
application/json
Your own ID for this record (letters, numbers, . _ : @ -). Required. Sending the same externalRef again never creates a second record; Fundor returns the first one.
Required string length:
1 - 200Pattern:
^[\w.:@-]+$The athlete's teamMemberId (from onboarding, join, or referral-link).
The person being referred (the customer).
Show child attributes
Show child attributes
Answers keyed by each service's formKey from GET /services. A service is selected when hasProvider is true, interested is yes or more-info, or wantsMoreInfo is true. At least one live service must be selected.
Show child attributes
Show child attributes
The customer's fundraising choice and the 9-month service commitment, shown with the wording from GET /consent.
Show child attributes
Show child attributes
Evidence that the person agreed to be contacted (TCPA). Every field except trustedFormCertUrl is required. If any is missing, stale or wrong, the lead is rejected with 400 and nothing is saved. See the Consent requirements page.
Show child attributes
Show child attributes
Response
A lead already exists for this externalRef. Nothing new was saved.