---
title: "Partner referrals"
url: https://docs.corefinity.com/guides/agencies/partner-referrals
type: guide
last_updated: 2026-11-13
feature: agency
related:
  - https://docs.corefinity.com/api/reference/agency/get-agency-page.md
  - https://docs.corefinity.com/api/reference/agency/list-agency-page-change-requests.md
  - https://docs.corefinity.com/api/reference/agency/get-agency-page-change-request.md
  - https://docs.corefinity.com/api/reference/agency/create-agency-page-change-request.md
  - https://docs.corefinity.com/api/reference/agency/list-agency-referrals.md
  - https://docs.corefinity.com/api/reference/agency/create-agency-referral.md
  - https://docs.corefinity.com/mcp/tools/corestack_agency_referrals_list.md
  - https://docs.corefinity.com/mcp/tools/corestack_agency_referral_get.md
  - https://docs.corefinity.com/mcp/tools/corestack_agency_referral_create.md
  - https://docs.corefinity.com/mcp/tools/corestack_agency_page_get.md
  - https://docs.corefinity.com/mcp/tools/corestack_agency_page_change_request.md
  - https://docs.corefinity.com/mcp/tools/corestack_agency_page_change_requests_list.md
---
# Partner referrals

Refer a business to Corefinity and keep a list of the referrals your agency has sent.

## Before you start

- You are signed in as a user of the agency.
- Your role is **Owner** or **Accounts / Project Manager**.
- You know the business's name and its website address. Everything else is optional.

## Send a referral

1. **Open Partner Referrals**

   Go to **Agency Portal › Partner Referrals** and choose **Create partner referral**.

   _Screenshot: The Partner Referrals page listing three referrals with their website, contact email, current provider, mobile and the time each was created. Create partner referral is ringed._

2. **Describe the lead**

   Enter the **Company Name of Lead** and the **Company Website of Lead**. Add the main contact, the **Current Provider of Lead**, the **Current Cost (Per Month, if known)** and **Notes** if you have them.

   _Screenshot: The Create Partner Referral form filled in for a made-up shop: company name, website, main contact name, email and mobile, current provider, a monthly cost, the contact box ticked, Email as the preferred contact method and a note. Create Partner Referral is ringed._

3. **Say who makes contact**

   Tick **Would you like us to contact the lead?** if Corefinity should get in touch, and choose **Email** or **Phone** under **Preferred Contact Method**. Leave it unticked to make the introduction yourself.

4. **Send it**

   Choose **Create Partner Referral**. **Create & Add Another** sends this one and opens an empty form.

Corefinity's sales team is told about the referral as soon as it is saved.

| Field                       | Rule                                                                     |
| --------------------------- | ------------------------------------------------------------------------ |
| **Company Website of Lead** | A domain such as `example.com`. The `https://` is optional.              |
| **Main Contact Email**      | A working email address.                                                 |
| **Main Contact Mobile**     | Choose the country, then enter the number. A UK number must be a mobile. |

## See what you have sent

1. **Open a referral**

   Choose a row in **Partner Referrals**. The list holds your agency's referrals only, whoever sent them.

   _Screenshot: A partner referral's details: the referring agency, the lead's company name and website, its main contact, current provider and monthly cost, a tick beside Would you like us to contact the lead, and the time it was created._

To correct a referral, choose the pencil button. To delete it, open its **…** menu.

## Automate this

**API:** [Create a partner referral](https://docs.corefinity.com/api/reference/agency/create-agency-referral.md), scope `write`

```bash
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": "eleanor.finch@harbourandfinch.example.com",
    "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"
  }'
```

**MCP:** [`corestack_agency_referral_create`](https://docs.corefinity.com/mcp/tools/corestack_agency_referral_create.md), scope `write`

```json
{
  "name": "corestack_agency_referral_create",
  "arguments": {
    "company_name": "Example Ltd",
    "website_url": "example.com",
    "main_contact_name": "Sam Smith",
    "main_contact_email": "sam@example.com",
    "preferred_contact_method": "email",
    "notes": "Moving to Corefinity this quarter."
  }
}
```

**Control Panel:** Agency Portal › Partner Referrals ([https://manage.corefinity.com/go/agency](https://manage.corefinity.com/go/agency))

## Related

- [Agency portal](/guides/agencies/agency-portal): Find the agency pages and tools.
- [Partner level](/guides/agencies/partner-level): See your agency's partner level.
- [Support tickets](/guides/support/raise-and-follow-a-ticket): Create a ticket and follow the answer.
