> 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/abc-ignite/abc-ignite-engagement-app/setting-up-perkville-in-the-abc-ignite-engagement-app.md).

# Setting up Perkville in the ABC Ignite Engagement app

Use this guide to connect participating Perkville locations to the ABC Ignite Engagement app and coordinate activation with your ABC account manager.

## Before you begin

* Make sure each participating club has a location in Perkville. See [Locations](https://docs.perkville.com/features/settings/location-setup/locations.md) for how to add a location and enter its name, address, timezone, language, and other details.
* If you are adding a club to an existing rewards program, follow [Adding a location to an existing program](https://docs.perkville.com/features/settings/location-setup/locations/add-and-configure-a-location.md) to review program rules, staff access, and the rest of the launch checklist.
* Confirm the separate [ABC Ignite data access requirements](https://docs.perkville.com/integrations/integration-reference/abc-ignite.md#connect-your-abc-ignite-data) with your Perkville Customer Success Representative (CSR). Entering a club ID does not replace data authorization or ABC's activation of the app extension.

{% stepper %}
{% step %}

### Determine a go-live date

**If you are new to Perkville**

Once you've determined your program's launch date, inform your ABC account manager that you'd like the app extension to be turned on on your go-live date. Update the account manager if there are any changes to your launch date.

**If you are already launched on Perkville**

Determine a go-live date for the app extension to be turned on in your app. We recommend 4 weeks of lead time. Inform your ABC account manager that you'd like the app extension to be turned on on this date.

{% hint style="warning" %}
Allow up to 4 weeks for Apple App Store and Google Play Store approval when planning activation.
{% endhint %}
{% endstep %}

{% step %}

### Add the ABC club IDs to their associated Perkville location

1. Open **Settings → Locations → External location IDs** in Perkville.
2. Select **ABC Ignite** as the external system.
3. Click **Add external location ID**, search for the corresponding Perkville location, and enter its ABC club ID.
4. Click **Save** and repeat for each participating location.

For a 4-digit ABC club ID, do not add a leading `0`.

See [External location IDs](https://docs.perkville.com/features/settings/location-setup/locations/external-location-ids.md) for the full instructions, including CSV import for multiple locations and how to update existing IDs. Use the ABC Ignite system-specific mapping described there.

Once ABC has enabled the extension and the club IDs are mapped correctly, members of those clubs can access the Perkville experience in the Rewards tab.

For clubs that are not participating, a rewards tab will still display. However, the tab will only show a “Coming Soon” page.

{% hint style="info" %}
Perkville cannot control whether the rewards tab appears in the ABC app or where ABC places it. ABC controls the app extension's availability and placement.
{% endhint %}
{% endstep %}

{% step %}

### Verify the member experience before launch

Confirm with your ABC account manager that the extension is enabled for the participating clubs. Then check the app with a representative member from each participating location:

* The Rewards tab opens the expected Perkville program.
* A member who has not connected their account can complete the [intro and joining steps](https://docs.perkville.com/integrations/integration-reference/abc-ignite/abc-ignite-engagement-app/intro-page.md) and [authorize ABC Fitness](https://docs.perkville.com/integrations/integration-reference/abc-ignite/abc-ignite-engagement-app/authorize-abc-fitness-page.md).
* The member can view the expected points, earning opportunities, rewards, and referral offer.

See the [ABC Ignite Engagement app guide](https://docs.perkville.com/integrations/integration-reference/abc-ignite/abc-ignite-engagement-app.md) for screenshots and supported features. Resolve any issues below before announcing the app experience to members.
{% endstep %}
{% endstepper %}

## Troubleshooting the Rewards tab

### The Rewards tab or Perkville entry is missing, inactive, or moved after an app update

First confirm with your ABC account manager that the Perkville app extension is enabled for the applicable clubs. ABC controls whether the extension appears in the app and where it is positioned, so changes to app navigation or an inactive extension entry may require ABC to update the app configuration.

### The Rewards tab opens but shows “Coming Soon” or does not recognize a participating club

Verify that the correct ABC club ID is associated with the correct Perkville location under **Settings → Locations → External location IDs**, with **ABC Ignite** selected. Follow [External location IDs](https://docs.perkville.com/features/settings/location-setup/locations/external-location-ids.md) to review or correct the mapping. For a 4-digit club ID, do not add a leading `0`.

### The extension opens, but Perkville data is missing or incorrect

If ABC confirms that the extension is enabled and the club ID mapping is correct, contact [Perkville Support](https://docs.perkville.com/overview/support.md). Include the ABC club ID, the corresponding Perkville location, and a screenshot or description of what the member sees so the integration can be investigated.


---

# 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/abc-ignite/abc-ignite-engagement-app/setting-up-perkville-in-the-abc-ignite-engagement-app.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.
