> 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/features/customers.md).

# Customers

Perkville’s Customers page is the central hub for managing loyalty and referral program participants. From this page, business staff can search for customers by name, email, or an external member ID from a connected system, add new customers to the program, and send invitations to join. Staff can also manage customer communication, view membership status, track point history and balances, manually adjust points, log activities, and void transactions when necessary. Additionally, they can handle account transfers and manage referrals by viewing or submitting them. To access these tools, click **Customers** in the left-hand navigation menu of the Dashboard.

## Accessing a customer's profile

To access and manage a customer's profile in Perkville:

1. Start from the Dashboard and click **Customers** in the left navigation menu.
2. Search by the customer's email address or name, or use **Filter by External Member ID** if you have the customer's ID from a connected system.
3. Click the customer's name from the search results.

### Searching by External Member ID

If your integration provides external member IDs to Perkville, select **Filter by External Member ID**, enter the member ID, and submit the search. If that ID is associated with a Perkville customer through the connected system, Perkville will display the matching customer record.

See Customer identifiers for more information about external member IDs and how they relate to Perkville profiles.

{% hint style="info" %}
If you know the customer's ID from the [Perkville API](https://www.perkville.com/developers/docs/v2/), you can go to the customer's profile by entering their `user_id` in the URL. For example: `https://www.perkville.com/biz/1234/customer/{user_id}/`
{% endhint %}

## When a member exists in your POS but not in Perkville

If you can find a person in ABC Ignite, Club Automation, or another connected membership system but cannot find them in Perkville:

1. **Check the customer search.** Search using the member's name and email address. If your integration provides an external member ID, try **Filter by External Member ID** using the value from the source system.
2. **Verify identifiers.** Compare the email, external member ID, business and location with the source system. Look for alternate emails or an existing Perkville profile with different contact information.
3. **Confirm the member qualifies.** Check whether your program includes that location, membership status/type, and any join or eligibility conditions.
4. **Check the integration.** Confirm the source record was created or updated and that the integration has had an opportunity to transmit the relevant member data. A record in the source system does not guarantee a Perkville profile has already been created.
5. **Escalate before duplicating.** If no matching account appears, contact [Perkville Support](/overview/support.md) with the business/location, source-system member ID, and approximate creation or update time. **Avoid manually creating a second profile** until Support confirms the correct next step.

See [Integration Reference](/integrations/integration-reference.md) for provider-specific setup information and [Customer identifiers](/features/customers.md) for more on searching integrated member IDs.

## Invite customers

Manually send invitations to customers to join your loyalty program by clicking **Invite** on the customer's profile.

You can also invite customers in bulk via the Invite customers page (accessible via your primary dashboard page).

{% hint style="info" %}
You can only send invites to pending customers.
{% endhint %}

## Manual points, redemptions, and adjustments

Business staff members can manually add points, redeem points, and make point adjustments.

{% hint style="info" %}
The ability to give or redeem points for a customer is dependent on the staff member’s role. Find the right person at your business who has these permissions if you do not.
{% endhint %}

<figure><img src="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2FLfBDZ7JqiJ17wldLtzLD%2FScreenshot%202025-06-20%20at%209.37.59%E2%80%AFAM.png?alt=media&#x26;token=2a4dd569-2458-40d7-b2ac-ff1dbbf20be5" alt=""><figcaption><p>Manually adding points to a customer's account</p></figcaption></figure>

To **add points** to the customer’s balance, click on the **Give points** button.

To **remove points** from the customer’s balance, click on the **Redeem points** button.

{% hint style="success" %}
**Point adjustments** allow you to provide a memo. Point adjustments don't send an email notification to your customers.
{% endhint %}

{% hint style="warning" %}
Choosing a redemption option will not trigger any actual transfer of goods. It merely deducts the number of points and records that the redemption occurred.
{% endhint %}

You can also add points to customers' profiles in bulk.

{% hint style="info" %}
If you are trying to remove a customer's points because their membership was cancelled, consider using the automatic cancellation-based expiration setting instead of manually removing points. See [Membership settings](/features/settings/memberships/settings.md).

Manual point changes and cancellation-based expiration are different workflows. Participation restrictions for inactive members can also affect which manual actions are available on an individual customer profile.
{% endhint %}

## Voiding transactions

You have the ability to void both earning and redeeming transactions, effectively reversing the transaction. This feature is helpful for correcting transactions made in error.

**How to void a transaction**

1. Access the customer profile.
2. Select the transaction you want to void by checking the box to the left of the transaction.
3. Click the **Void transaction** button.

{% hint style="info" %}
Only staff members with [Employee or Admin level permissions](/features/settings/staff-members.md#staff-member-roles) can void transactions.
{% endhint %}

## View and submit referrals

You can view pending and completed referrals by clicking **View referrals** on a customer's profile.

To manually submit a referral, click **Submit referral**. You will then be prompted to enter the email address of the friend being referred.

### If the friend is already a member of your business

If the friend being referred is already a member of your business, you will receive a notification warning that the referred friend has already earned points at the business. Depending on your staff role, you'll be able to override this warning and award the referral bonus manually.

## Change a voucher status

You can mark a customer's vouchers as USED or UNUSED by locating their redemption via their customer history page and then clicking on the status.

## Manage the customer's email

You can manage a customer's email addresses by clicking **Manage emails** on the right hand side of their customer profile. This page describes the rules for managing customers' email addresses.

### Switching the primary email

If a customer has a registered account and multiple confirmed email addresses (not pending), you can switch the primary email among those confirmed ones. Simply click the **Make primary** button next to the email you want to set as the primary email address.

{% hint style="info" %}
If a customer has a pending account, you can switch the primary email between unconfirmed emails as well.
{% endhint %}

### Adding and removing emails

You can add and remove emails from most accounts, but not under certain conditions, such as when the customer is also a staff member at a business on Perkville.

## Troubleshooting missing points or widespread access issues

When a customer reports missing points, first review their profile's transaction history and confirm the qualifying activity, date, and location. If no qualifying transaction was recorded, check whether the source POS, membership, or booking system supplied it to Perkville. See [Automating your program using Perkville's API](/integrations/integrating-perkville/automating-your-program-using-perkvilles-api.md) for integration considerations.

If **multiple customers** report missing points, login problems, or inaccessible balances at the same time, do not begin by manually adjusting every account. Instead:

1. Check whether the reports affect one location, integration, or a larger group of customers.
2. Record the start time and timezone, affected locations, approximate number of reports, and exact error message or symptom.
3. Collect two or three representative customer examples and the relevant activity timestamps or external transaction identifiers. Share personal data only through approved support channels.
4. Confirm whether the underlying POS or membership system recorded the activity and whether any integration configuration recently changed.
5. Contact [Perkville Support](/overview/support.md) at **<support@perkville.com>** with the collected information. Indicate clearly if the issue is affecting many customers or preventing access to the program.

Avoid repeatedly replaying transactions or making mass point adjustments before the cause is established, as this could create duplicate awards. For individual questions about program rules or reward eligibility, the customer's business remains the first point of contact.


---

# 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/features/customers.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.
