Referral Link Attributions

Create a referral link attribution

Create a referral attributed to a partner's referral link, typically from the lid and cid values your CRM captured from the visitor. Requires partners_edit.

Send referral_link_id (the lid value), click_uuid (the cid value), or both. With only click_uuid, the referral link is resolved from the click. The referral link must be active, and a lead form must be configured on the partner type or the account.

The referral is created as open, or as accepted if your referral link settings say so.

Idempotency

A CRM deal, opportunity or lead ID (hubspot_deal_id, salesforce_opportunity_id, salesforce_lead_id, pipedrive_deal_id) belongs to one referral. If a referral already carries the ID you send, that referral is returned with 200 OK and nothing is created, so a re-fired workflow is safe. If it belongs to a different partner than the referral link's, you get a 409 instead.

post/referral_link_attributions

Request

  • Base URL: https://api.lassotech.com/api/v1/rest
  • URL: https://api.lassotech.com/api/v1/rest/referral_link_attributions
  • Auth: API key in header x-lasso-access-token

Request body

referral_link_idstring

Identifier of the active referral link (for example RL-3930CB). Required if click_uuid is not provided.

click_uuidstring uuid

UUID of a referral link click. If provided, the referral link is resolved from the click.

referral_company_namestring

Company name of the referral

referral_emailstring

Email of the referral contact. When omitted, the referral is stored with a generated placeholder address.

referral_contact_namestring

Name of the referral contact

hubspot_deal_idstring

HubSpot deal ID

hubspot_contact_idstring

HubSpot contact ID

hubspot_company_idstring

HubSpot company ID

salesforce_opportunity_idstring

Salesforce opportunity ID

salesforce_account_idstring

Salesforce account ID

salesforce_lead_idstring

Salesforce lead ID

salesforce_contact_idstring

Salesforce contact ID

pipedrive_organization_idstring

Pipedrive organization ID

pipedrive_person_idstring

Pipedrive person ID

pipedrive_deal_idstring

Pipedrive deal ID

Example request

{
  "referral_link_id": "RL-3930CB",
  "click_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "referral_company_name": "Lead Inc",
  "referral_email": "lead@example.com",
  "referral_contact_name": "Jane Doe",
  "hubspot_deal_id": "12345",
  "hubspot_contact_id": "67890",
  "hubspot_company_id": "11111",
  "salesforce_opportunity_id": "006...",
  "salesforce_account_id": "001...",
  "salesforce_lead_id": "00Q...",
  "salesforce_contact_id": "003...",
  "pipedrive_organization_id": "100",
  "pipedrive_person_id": "200",
  "pipedrive_deal_id": "300"
}

Response

A referral already carries this CRM opportunity ID; it is returned and nothing is created

Example response

{
  "lead": {
    "slug": "abc-123",
    "source_type": "referral_link",
    "company_name": "Lead Company",
    "contact_name": "Jane Doe",
    "email": "jane@leadco.com",
    "partner_slug": "acme-corp",
    "partner_lasso_key": "P-A1B2C3",
    "partner_member": {
      "slug": "PC-A1B2C3"
    },
    "currency_code": "USD",
    "billing_start_date": "2026-10-01"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.