---
title: "ReCharge API Key/Token"
slug: "recharge-api-key"
updated: 2023-06-20T19:36:18Z
published: 2023-06-20T19:36:18Z
canonical: "docs.bellwethr.com/recharge-api-key"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bellwethr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ReCharge API Key/Token

## What does the API Key/Token do?

Adding a ReCharge API Token to the RetentionEngine Builder is the first step to connecting RetentionEngine to your ReCharge store.

The API Key allows the RetentionEngine to automatically update customer accounts with discounts, pauses, or cancellations.

## Creating the API Token in ReCharge

### Step One

Log into your **Shopify** admin panel and open the ReCharge App.

![first.png](https://cdn.document360.io/ac5d6d3b-d1b3-4a56-b758-d584b80df54b/Images/Documentation/first.png)

### Step Two

Click on the "Integrations" tab and click "API tokens..."

![API Tokens Tab](https://cdn.document360.io/ac5d6d3b-d1b3-4a56-b758-d584b80df54b/Images/Documentation/Screenshot%202023-06-20%20at%2018.52.39.png)

          Don't see the API Token?

          

If you don't see this option in the upper right corner, you'll need to reach out to ReCharge's support team to enable this for you. Send a support email to ReCharge and they will quickly get this added for you.

### Step Three

#### A. Click on "Create an API token"

![Create API Token](https://cdn.document360.io/ac5d6d3b-d1b3-4a56-b758-d584b80df54b/Images/Documentation/Screenshot%202023-06-20%20at%2018.53.15.png)

#### B. Set your Token Nickname to "RetentionEngine"

![api token nickname.png](https://cdn.document360.io/ac5d6d3b-d1b3-4a56-b758-d584b80df54b/Images/Documentation/api%20token%20nickname.png)

#### C. Make sure to also set the permissions as instructed below:

![Screenshot 2023-06-20 at 21.32.13.png](https://cdn.document360.io/ac5d6d3b-d1b3-4a56-b758-d584b80df54b/Images/Documentation/Screenshot%202023-06-20%20at%2021.32.13.png)

          Important Note!!

          

If your permissions don't match above, your API Token will not work. Please make sure you have editted the permissions for **ONLY** the following:

- **Orders:** Read & Write access
- **Discounts**: Read & Write access
- **Subscriptions:** Read & Write access
- **Payments:** Read access
- **Customers:** Read & Write access
- **Store Information:** Read access

## Pasting the API Token into the RetentionEngine Builder

### Step Four

****Copy the ReCharge API token....**** ![highlighted api key.png](https://cdn.document360.io/ac5d6d3b-d1b3-4a56-b758-d584b80df54b/Images/Documentation/highlighted%20api%20key.png)

****....and return to the RetentionEngine builder:**** ![Screen Shot 2020-12-08 at 3.46.57 PM.png](https://cdn.document360.io/ac5d6d3b-d1b3-4a56-b758-d584b80df54b/Images/Documentation/Screen%20Shot%202020-12-08%20at%203.46.57%20PM.png)

### Step Five

Choose ReCharge as your billing system integration and paste the ReCharge API Key. ![ezgif-1-269103041627.gif](https://cdn.document360.io/ac5d6d3b-d1b3-4a56-b758-d584b80df54b/Images/Documentation/ezgif-1-269103041627.gif)

Once those fields are pasted, you're API Key has been added, and you can continue to the RetentionEngine Dashboard!

![proceed to dash](https://cdn.document360.io/ac5d6d3b-d1b3-4a56-b758-d584b80df54b/Images/Documentation/proceed%20to%20dash.png)