> For the complete documentation index, see [llms.txt](https://support.referralhero.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.referralhero.com/campaign-management/subscribers/update-referral-status.md).

# Update Referral Status

You can update or change the status of a referral in serval ways depending on your desired campaign setup. Please familiarize yourself with our [Referral Status](/campaign-management/subscribers/subscriber-profile.md#referral-status) before attempting to update them.

* Update referrals via CSV
* Update referrals manually
* Update referrals via our [native Zapier App](/campaign-builder/integrations/zapier.md)
* Update referrals via our [JavaScript](/integrate/javascript-web-api.md) or [REST API](/integrate/rest-api.md)

## Update Referrals via CSV

This feature enables bulk updates of referral status by uploading a CSV (Comma-Separated Values) file. This is especially useful for efficiently changing the status of numerous referrals.

#### CSV File Requirements

To successfully update referral status using a CSV file, ensure the following requirements are met:

* The CSV file must have lowercase headers:
  * `unique_identifier` (referral unique identifier)
  * `status` (referral status)
* Use the following values in the `status` column:
  * `unconfirmed`
  * `confirmed`
  * `unqualified`

#### Updating Referrals via CSV

1. Navigate to **Subscribers → Bulk Referral Update**
2. Select the campaign from the dropdown
3. In the **Update Referral Status** section, choose the CSV file
4. Click **Upload**

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

Referral status changes are processed based on the CSV file’s `status` column values.

* Referrals can move directly between linear stages (e.g. `pending` → `confirmed`) without passing through the `unconfirmed` stage
* Referrals can be moved to `unqualified` from any current status

\
**Reward Triggers**

If you have configured rewards for specific referral statuses:

* Rewards will be triggered for referrals updated to `unconfirmed` or `confirmed`
* Unqualified referrals remain part of the system and may still be evaluated based on your reward configuration

## Update Referrals Manually

This feature allows you to update referral status individually through the dashboard.

Referrals can be marked as:

* Unconfirmed
* Confirmed
* Unqualified

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

The available options in the **Actions** dropdown may vary based on your campaign configuration.

#### Reward Triggers

If you have set up rewards for unconfirmed or confirmed referrals, the appropriate rewards will be triggered when a referral is updated to those statuses.


---

# 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://support.referralhero.com/campaign-management/subscribers/update-referral-status.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.
