> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subtotal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Introduction
> Connect Okendo and configure how customers are rewarded.
## Overview
Our integration with [Okendo](https://www.okendo.io) makes it easy to reward customers for linking accounts and making retail purchases.
We'll show you how to set up your program with Okendo and make the most out of this integration.
## Get your Okendo credentials
Sign in to your Okendo admin and navigate to *Settings -> Integrations -> Credentials*. You'll need two values:
* **User ID** — the unique user ID for your store
* **Merchant REST API Key** — click `Generate` to create one
## Connect your Okendo account
Sign in to the Subtotal Dashboard and connect your Okendo account to enable the integration.
Navigate to [*Integrations -> Okendo -> Connect*](https://dashboard.subtotal.com/integrations/okendo).
Click the `Connect Okendo` button.
Provide your Okendo User ID and Merchant REST API Key, then click `Save Integration`.
You should now see an `Active` status on the Okendo integration page.
## Configure actions
After connecting, configure the actions Subtotal should send to Okendo. Each action maps a Subtotal event (e.g. an account being linked, a purchase being made) to a custom earning rule you've set up in Okendo.
| Setting | Description |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Customer identifier** | The field on the connection used to identify the customer in Okendo. The Subtotal Okendo integration currently only supports identifying customers by **Email**. |
| **Actions** | One or more event-to-earning-rule mappings. Each action specifies the event type, retailers it applies to, and the Okendo earning rule ID. |
To add an action, click `Add action` and choose an event:
Each action requires:
| Field | Description |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Event** | `account.linked` (fired when a customer links a retailer account) or `purchase.created` (fired for each purchase Subtotal collects). |
| **Action name** | A human-readable label for this action. |
| **Retailers** | Restrict the action to specific retailers, or apply it to all. |
| **Okendo earning rule ID** | The `Action ID` of the custom earning rule you configured in Okendo. |
See [Rewarding linked accounts](/docs/integrations/okendo/linked-account) and [Rewarding purchases](/docs/integrations/okendo/purchases) for how to set up the matching custom earning rules in Okendo.
## Customer identification
The Okendo integration identifies customers by their **email address**. How the email is captured depends on your setup:
* **Shopify app** — the customer's email is captured automatically from their Shopify profile. No additional parameters needed.
* **API integration** — include the `email` field when creating a connection via [`POST /connections`](/docs/api-reference/connections/create). Without it, Subtotal won't be able to identify the customer in Okendo.