> For the complete documentation index, see [llms.txt](https://docs.perkville.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perkville.com/integrations/integration-reference/mariana-tek/referral-lead-sync.md).

# Referral Lead Sync

Perkville can automatically send referral leads directly into Mariana Tek when a referred friend claims a referral offer. This means your sales and marketing teams can follow up with referred prospects using Mariana Tek’s tools, including Xplor Growth for marketing automation.

For the overall referral-to-CRM flow and supported destination examples, see [Referral lead syncs](https://docs.perkville.com/features/referrals/referral-lead-syncs.md).

Below is an overview of the flow from referral to prospect creation in Mariana Tek:

{% stepper %}
{% step %}

### Friend is referred

One of your customers refers a friend via email or a referral link.
{% endstep %}

{% step %}

### The friend claims the referral

The friend claims the [referral offer](https://docs.perkville.com/features/referrals/configuring-your-referral-program/referral-offer.md).

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2FVyK0docdMDzVn8TjfiaF%2FScreenshot%202025-07-14%20at%202.14.50%E2%80%AFPM.png?alt=media&#x26;token=4232c12a-bb1b-4813-859e-70811d185e81" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### The new prospect is created in Mariana Tek

If a user does not already exist for the new lead, Perkville creates a new record for the lead with the following fields: first name, last name, email, phone (if provided), date of birth (if provided). A `perkville-referral` tag is applied to the new user. This tag facilitates the sync into Xplor Growth.

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2FyvS7fOdSOdBv6Sf1shrs%2FScreenshot%202025-07-14%20at%204.20.52%E2%80%AFPM.png?alt=media&#x26;token=8d410bbe-5f4c-4d80-a664-5bd19d4df8be" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## From lead creation to a completed referral

Sending a prospect to Mariana Tek is a **lead-follow-up** workflow. Completing the referral and delivering any incentives are separate steps determined by your Perkville program and connected workflows.

| Stage                               | What happens                                                                                                                                                 | Requirements or limitations                                                                                                                                                                                                                       |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **1. Referral shared**              | An existing member shares the Perkville [referral offer](https://docs.perkville.com/features/referrals/configuring-your-referral-program/referral-offer.md). | Sharing a link is not proof of a conversion.                                                                                                                                                                                                      |
| **2. Offer claimed**                | The referred friend claims the offer in Perkville.                                                                                                           | This is the trigger for the configured Mariana Tek lead sync; a claim alone does not award the referrer.                                                                                                                                          |
| **3. Prospect sent to Mariana Tek** | For a new prospect, Perkville can create a Mariana Tek user and apply the `perkville-referral` tag for follow-up, including through Xplor Growth.            | Requires an enabled referral-lead sync. The existing-user case should be confirmed with Perkville rather than assuming a duplicate is created.                                                                                                    |
| **4. Qualifying action**            | The friend later completes an activity such as a first qualifying class or membership purchase.                                                              | The activity must be received by Perkville and configured to **complete referrals**. The timing, activity and eligibility depend on your integration and [earning rules](https://docs.perkville.com/features/referrals/completing-a-referral.md). |
| **5. Referrer's reward**            | Perkville completes the eligible referral and awards the configured referrer incentive, such as points or an instant reward.                                 | The reward follows your [completed-referral reward configuration](https://docs.perkville.com/features/referrals/configuring-your-referral-program/define-the-reward-for-completed-referrals.md). Prospect creation alone does not trigger it.     |

The **referred friend's offer** is separate from the **referrer's reward**. If the offer provides a free class, discount, or another incentive, communicate how the friend claims it in the offer's instructions. Creating a Mariana Tek prospect does **not** establish that the friend's incentive has been automatically applied to their Mariana Tek account. Any credit, coupon, or voucher delivery requires its own supported configuration; see [Automated reward redemptions](https://docs.perkville.com/integrations/integration-reference/mariana-tek/automated-reward-redemptions.md) for the separate, connected-credit reward workflow.

## FAQ

### Does a referral lead appearing in Mariana Tek mean the referrer earned points?

No. Lead delivery helps your team follow up. A referral is completed only when the referred person performs an activity that your Perkville program recognizes as completing referrals. See [Completing a referral](https://docs.perkville.com/features/referrals/completing-a-referral.md).

### How do I choose what qualifies as a referral conversion?

Configure a referral-completing earning rule or activity in Perkville, then verify that the intended Mariana Tek activity is being received and matched to the referred person. Work with your Perkville Customer Success Representative to test the flow before launch.

### Does the referred friend automatically receive a reward when their prospect record is created?

Not from the lead-sync step alone. The friend's offer and any voucher or connected fulfillment process must be configured separately. Follow the instructions in your [referral offer](https://docs.perkville.com/features/referrals/configuring-your-referral-program/referral-offer.md), and confirm any Mariana Tek credit or coupon delivery before promising automatic fulfillment.

### How to get this setup

1. Make sure you have [a referral earning activity and offer set up](https://docs.perkville.com/features/referrals/configuring-your-referral-program.md).
2. Reach out to **<support@perkville.com>** and let them know you'd like this setup.
3. Add the following language to your referral offer fine print: "An account will be created for you. To sign into your new account at {your business name} go to https\://{your-tenant-subdomain}.marianatek.com/auth/login/ and click to reset your password."

{% hint style="warning" %}
The new user record in Mariana Tek will be created with a temporary password. They will have to reset their password upon logging into Mariana Tek for the first time.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.perkville.com/integrations/integration-reference/mariana-tek/referral-lead-sync.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
