Create a partner referral
Records a lead as your own agency's referral and emails Corefinity's sales team about it. Your role needs the createAgencyLeads permission.
Body
Up to 255 characters.
Whether Corefinity may contact the lead directly. false when left out.
0 to 99999999.
Up to 255 characters.
An address whose domain can receive email; the domain is looked up, so the placeholder address in the example is refused 422 on this field. Up to 255 characters.
A mobile number. It is checked against main_contact_mobile_country and saved in international form. Up to 32 characters.
The two-letter country code of the mobile number, such as GB. A UK number needs none. Up to 2 characters.
Up to 255 characters.
Up to 65,535 characters.
emailphonenullA host name, with or without http:// or https://, and with a path if you like. Up to 255 characters.
Returns
201 The referral was recorded.
Fields of the 201 answer
A lead your agency referred to Corefinity.
Fields
Whether Corefinity may contact the lead directly.
Format: date-time.
What the lead pays for hosting today.
Who hosts the lead today.
At least 1.
The mobile number in international form, such as +447700900123.
The two-letter country code the number was read with.
Your notes. When Corefinity may contact the lead and the contact's mobile or email is missing, a line saying so is added.
emailphonenullThe lead's website, as it was typed. The scheme is optional.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | forbidden | The person is not allowed to do this. |
403 | scope_required | Use a token with the scope named in scope. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X POST https://manage.corefinity.com/api/agency/referrals \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"company_name": "Harbour & Finch",
"contact_lead": true,
"current_cost": 120.5,
"current_provider": "Another host",
"main_contact_email": "[email protected]",
"main_contact_mobile": "07700 900123",
"main_contact_mobile_country": "GB",
"main_contact_name": "Eleanor Finch",
"notes": "Moving this quarter.",
"preferred_contact_method": "phone",
"website_url": "https://harbourandfinch.example.com"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/agency/referrals', [
'company_name' => 'Harbour & Finch',
'contact_lead' => true,
'current_cost' => 120.5,
'current_provider' => 'Another host',
'main_contact_email' => '[email protected]',
'main_contact_mobile' => '07700 900123',
'main_contact_mobile_country' => 'GB',
'main_contact_name' => 'Eleanor Finch',
'notes' => 'Moving this quarter.',
'preferred_contact_method' => 'phone',
'website_url' => 'https://harbourandfinch.example.com',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/agency/referrals', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
company_name: 'Harbour & Finch',
contact_lead: true,
current_cost: 120.5,
current_provider: 'Another host',
main_contact_email: '[email protected]',
main_contact_mobile: '07700 900123',
main_contact_mobile_country: 'GB',
main_contact_name: 'Eleanor Finch',
notes: 'Moving this quarter.',
preferred_contact_method: 'phone',
website_url: 'https://harbourandfinch.example.com',
}),
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.post(
"https://manage.corefinity.com/api/agency/referrals",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"company_name": "Harbour & Finch",
"contact_lead": True,
"current_cost": 120.5,
"current_provider": "Another host",
"main_contact_email": "[email protected]",
"main_contact_mobile": "07700 900123",
"main_contact_mobile_country": "GB",
"main_contact_name": "Eleanor Finch",
"notes": "Moving this quarter.",
"preferred_contact_method": "phone",
"website_url": "https://harbourandfinch.example.com",
},
)
data = res.json() if res.content else None{
"data": {
"company_name": "Harbour & Finch",
"contact_lead": true,
"created_at": "2026-11-09T10:15:00Z",
"current_cost": 120.5,
"current_provider": "Another host",
"id": 3120,
"main_contact_email": "[email protected]",
"main_contact_mobile": "+447700900123",
"main_contact_mobile_country": "GB",
"main_contact_name": "Eleanor Finch",
"notes": "Moving this quarter.",
"preferred_contact_method": "phone",
"website_url": "https://harbourandfinch.example.com"
}
}{
"message": "Unauthenticated."
}{
"code": "forbidden",
"message": "You are not allowed to create partner referrals.",
"reason": "forbidden",
"status": "error"
}{
"code": "invalid",
"errors": {
"company_name": [
"The company name field is required."
],
"website_url": [
"The website url field is required."
]
},
"field": "company_name",
"message": "The company name field is required. (and 1 more error)",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it is off for this endpointIt sends email to real people. Copy the request and run it yourself when you are sure.