CorefinityCorefinityDocs
Open the Control PanelControl Panel
Agency · 3 of 7

corestack_agency_referral_create

Refer a lead.

Scope writeNo secrets returned
On this page

When to use it

Refer a lead to Corefinity for your agency, as the Partner Referrals form in the Control Panel does and POST /api/agency/referrals. The referral is your agency's. Corefinity's sales team is emailed and told in Slack as soon as it is saved, so confirm the details with the person first. Answers the referral as corestack_agency_referral_get.

Ask for it

Prompt
Using the Corefinity MCP server, call corestack_agency_referral_create with company_name Example Ltd, website_url example.com, main_contact_name Sam Smith, main_contact_email [email protected], preferred_contact_method email, notes Moving to Corefinity this quarter.. (Refer a lead.) Tell me what it returned.

Inputs

company_namestringRequired

Up to 255 characters.

contact_leadboolean

Corefinity may contact the lead directly.

current_costnumber

What they pay today. At least 0.

current_providerstring

Who hosts them today. Up to 255 characters.

main_contact_emailstring

An address whose domain receives mail. Up to 255 characters.

main_contact_mobilestring

Checked together with main_contact_mobile_country, as the form checks them, and stored in international form. Up to 32 characters.

main_contact_mobile_countrystring

The mobile number's country. Up to 2 characters.

main_contact_namestring

Up to 255 characters.

notesstring

Up to 65,535 characters.

preferred_contact_methodstring
emailphone
website_urlstringRequired

The lead's website, such as example.com or https://www.example.com (http or https only). Up to 255 characters.

Example call

tools/call
{
  "name": "corestack_agency_referral_create",
  "arguments": {
    "company_name": "Example Ltd",
    "website_url": "example.com",
    "main_contact_name": "Sam Smith",
    "main_contact_email": "[email protected]",
    "preferred_contact_method": "email",
    "notes": "Moving to Corefinity this quarter."
  }
}

If it is refused

ReasonWhat to do
forbiddenYour roles do not let you create partner referrals.
invalid_argumentsOn the field named, with the form's message (for example a website that is not a web address, or a mobile number that does not fit its country).
tenant_mismatchThe object does not exist or the token may not see it. Check the id.
scope_requiredThe token lacks a scope this call needs. Open the link in the answer to add it, then call again.
pin_refusedThe grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it.
rate_limitedToo many calls. Wait for the number of seconds the answer names.
temporarily_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
internal_errorSomething went wrong on our side. Quote the trace id to support.

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT