> For the complete documentation index, see [llms.txt](https://uni.fotello.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://uni.fotello.co/customer-portal/agent-referrals.md).

# Agent Referrals

Agent Referrals turns your happy customers into a growth channel. When one of your agents shares their referral code, a new agent gets a discount on their first order — and the agent who referred them earns the same reward. You set the discount, and Fotello tracks every referral and applies the reward automatically.

### Turn on Agent Referrals

You set up and manage the program from your dashboard.

{% stepper %}
{% step %}
**Open the Referrals app**

In your dashboard, go to **Apps**. Under **Apps by Fotello**, click the **Referrals** app.

<figure><img src="/files/rokfToMocMN1UCQzg9IA" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Set the reward**

Open the **Settings** tab and choose the discount both agents receive:

* **Discount type** — pick **Percentage** or **Fixed amount**.
* **Percent off / Amount off** — enter the value.

<figure><img src="/files/loKuhOIpb3R9MKH81glS" alt=""><figcaption></figcaption></figure>

As you type, a **Reward preview** shows exactly what agents will see (for example, *Give 10%, get 10%*).
{% endstep %}

{% step %}
**Save to turn it on**

Click **Save discount**. Saving your reward for the first time turns the program on, and a **Connected** badge appears at the top of the app.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
You can change the reward any time from the **Settings** tab. Updated rewards apply to new referrals going forward.
{% endhint %}

### Pause or restart the program

Use the **Disconnect** button at the top of the Referrals app to pause the program. Your reward settings are kept, so you can pick up right where you left off — use **Connect** to turn it back on.

### What your agents see

Once the program is on, your customers get a **Referrals** section in their portal where they can:

* View their reward (for example, *Give 10%, get 10%*)
* Copy their personal **referral code**
* Copy a ready-to-share **invite link**

They share the code or link with other agents. When a new agent signs up through it, the discount is applied to their first order automatically — there's no code to enter by hand.

{% hint style="info" %}
The referring agent earns their matching reward once the new agent's first order is paid. It then applies to that agent's next order.
{% endhint %}

### Track your referrals

Open the **Referrals** tab inside the Referrals app to see every referral in one place. For each one you can see:

* **Referrer** and **Referee** — who invited whom
* **Status** — how the referral is progressing (for example, *Signed up*, *Order placed*, or *Rewarded*)
* **Discount / Reward** — the reward applied
* **Order value** — the total of the new agent's first order
* **Date** and **Paid date**

Use the search box to quickly find a referral by agent name or status.

### Why this matters for your business

* **Grow through word of mouth** — Your best customers bring you new ones, with a built-in reason to spread the word.
* **Rewards on autopilot** — Fotello applies the discount at checkout and tracks every referral, so there's nothing to manage by hand.
* **You stay in control** — Set the reward that works for your business, and adjust or pause it whenever you like.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://uni.fotello.co/customer-portal/agent-referrals.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.