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

# Integrations overview

### Overview

Integrations are core to Perkville's functionality as a loyalty and referral platform. Backend integrations automate data exchange between Perkville and your business systems, such as attendance, purchases, membership status, and configured referral-lead delivery. [**Middle**](https://docs.perkville.com/integrations/middle-integration-capabilities.md) is Perkville's integration platform for these workflows. Some established customers also use legacy Perkville-managed backend integrations; existing setup instructions remain available where relevant.

Developers can use the [Perkville public API](https://www.perkville.com/developers/docs/v2/) for supported customer-facing mobile and web experiences and other authorized integrations. A backend data connection does not automatically mean your member app includes Perkville screens; similarly, an app tab or program link does not establish that purchase, membership, or referral data is synchronized.

See [Middle integration capabilities](https://docs.perkville.com/integrations/middle-integration-capabilities.md) for the current documented Middle connectors, common use cases, and how Middle differs from a native Perkville integration or direct API integration.

### Choosing an integration approach

| Approach                                                                                                                           | What it provides                                                                         | What it does not imply                                                                     |
| ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| [Middle-powered backend automation](https://docs.perkville.com/integrations/middle-integration-capabilities.md)                    | Configured synchronization and workflows between business software and Perkville         | A native member app experience or automatic reward fulfillment unless separately supported |
| Existing legacy Perkville-managed backend connection                                                                               | Continued integration for supported existing customers                                   | A generally available new integration option                                               |
| [Public API for custom apps](https://docs.perkville.com/integrations/integrating-perkville/integrating-your-app-with-perkville.md) | Developer-built loyalty, referral, and reward experiences using supported Perkville APIs | A ready-made UI or backend POS connection                                                  |
| Partner mobile app integration                                                                                                     | A partner-specific embedded tab or integrated member experience when supported           | The same capabilities across every app partner                                             |
| Link to a hosted Perkville program                                                                                                 | Opens Perkville from another website or app                                              | Native screens, automatic sign-on, or data synchronization                                 |

For provider-specific data flows, limitations, and setup, see the [Integration Reference](https://docs.perkville.com/integrations/integration-reference.md).

### Mobile app integrations

Perkville can be integrated into your business's mobile app so customers can access your loyalty and referral program within the app they already use. Partner apps that offer Perkville integrations include:

* [**Mariana Tek**](https://docs.perkville.com/integrations/integration-reference/mariana-tek/5th-tab-integration.md)**:** Add Perkville as an integration tab in your Mariana Tek-powered mobile app.
* [**ABC Fitness's ABC Ignite Engagement app**](https://docs.perkville.com/integrations/integration-reference/abc-ignite/abc-ignite-engagement-app.md)**:** Let members view their points, see ways to earn, redeem rewards, and refer friends within your branded app.

For businesses and app partners building a custom experience, Perkville offers APIs specifically designed to help mobile app developers integrate loyalty and referral features into their apps. These APIs support experiences such as joining the loyalty program, viewing point balances and history, browsing earning opportunities and rewards, redeeming rewards, referring friends, and tracking challenge progress.

See [Integrating Your App with Perkville](https://docs.perkville.com/integrations/integrating-perkville/integrating-your-app-with-perkville.md) for developer guidance on authentication, member-specific data, and building these screens and flows. The guide also covers web apps.

### Other integrations

Key Perkville integrations include:

* **Customer relationship management (CRM)**: Syndicate referred prospects to your CRM for follow up sales and marketing efforts.
* **Email and texting Services**: Trigger emails and text messages based on behaviors and data in Perkville.
* **Fitness wearables**: Reward "effort" tracked by fitness wearables.
* **Marketing automation**: Synchronize Perkville data such as point balance and loyalty program status with your marketing automation platform so you can leverage it in your marketing efforts.
* **Membership management**: Automatically integrate your members for eligibility and invitation to your loyalty program. Incentivize membership upgrades. Automatically expire points upon membership cancellation.
* **Point of Sale (POS)**: Automatically reward specific retail and service purchases.
* **Scheduling systems**: Automatically reward specific class and appointment attendance.
* **Survey tools**: Increase survey response rates by rewarding surveys such as NPS.

For a detailed list of our current partners and integration capabilities, visit our [partners page](https://partners.perkville.com/).

We are continually expanding our integration capabilities to better serve your business needs. If there is a platform you are using that you would like to see integrated with Perkville, please feel free to [**contact us**](https://partners.perkville.com).


---

# 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/overview.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.
