# Fetch loyalty points in Emarsys > Let's set up Emarsys to retrieve the loyalty balance of a customer from Talon.One. > For the complete documentation index, see [llms.txt](https://docs.talon.one/llms.txt). To do so, we rely on the Emarsys-specific [Get loyalty balance](/third-party-api#tag/Emarsys/operation/emarsys/getLoyaltyProgramBalance) endpoint. ## Talon.One requirements - You are an [admin](/docs/product/account/account-settings/manage-roles.md#admin-role) user. - You have set up an [Application](/docs/product/applications/create-and-manage-applications.md) that contains [customer profiles](/docs/product/applications/display-customer-profiles.md). - You have set up a [profile-based loyalty program](/docs/product/loyalty-programs/profile-based/create-pb-programs.md). ## Emarsys requirements - You have set up your Emarsys account. - You have an active Emarsys campaign for which you want to send emails containing loyalty information. In this tutorial, we'll use a **block-based email campaign**. ## Set up the integration ### Create an API key in Talon.One In the Campaign Manager, create an Emarsys-specific API key: 1. In your Application, click **Settings** > **Integration API Keys**. 1. Click **Create API Key**. 1. In the **Create API Key** drawer, if you are asked for a key type, select **Production**. 1. In **Key name**, type a name to identify the key. 1. In **Key expiration date**, select a date. :::tip Avoid choosing expiration dates that fall at the end of the year or during other high-traffic periods. ::: 1. In **Third-party integration**, select **Yes**. 1. From **Platform**, select **{props.partner}**. 1. Click **Create API Key**. 1. Click to copy the key for use. :::note You cannot view or copy the API key after closing the drawer. ::: ### Create a connection in Emarsys To retrieve loyalty ledger information from Talon.One, we call the following endpoint: ```text title="POST Get loyalty balance" https://integration.talon.one/emarsys/loyalty_programs/profile/balance ``` To access this endpoint, create an External Content connection in Emarsys: 1. Sign in to your Emarsys account. 1. Open **Content** > **External Content**. 1. Click **Create Connection**. 1. In **Connection**, enter the following details: - **Name**: A descriptive name for the connection. - **API URL**: `https://integration.talon.one/emarsys/loyalty_programs/profile/balance?deployment=YOUR_DEPLOYMENT_URL`, where `YOUR_DEPLOYMENT_URL` is the base URL of your Talon.One deployment, for example, `mycompany.europe-west1.talon.one`. 1. In **Authentication**, enter the following details: 1. **Method**: **HTTP basic authentication** 1. **User name**: `ApiKey-v1` 1. **Password**: The Emarsys-specific API key you [created](#create-an-api-key-in-talonone). 1. In **Fields**, enter the following details: - **Reference Fields**: | Field name | Value for testing | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `integrationId` | An existing Talon.One customer integration ID. Example: `URNGV8294NV`. | | `loyaltyProgramId` | The ID of your profile-based loyalty program in Talon.One. Example: `14`. | | `subledgerId` | (Optional) The ID of the subledger from which to retrieve the loyalty balance. If not provided, the loyalty balance is retrieved from the main ledger. Example: `my-subledger`. | - **Response Fields**: The loyalty ledger attributes to retrieve.For example, add an `activeBalance` response field to retrieve the current loyalty point balance of a customer. 1. To test the connection with the values provided, click **Test**. 1. If the test is successful, click **Save**. ### Create tokens in Emarsys To use a loyalty attribute in your Emarsys campaign, create a [personalization token](https://esl.emarsys.com/hc/en-us/articles/12279054632337-Tokens): 1. In Emarsys, open **Content** > **Personalization**. 1. Click **Create Token** and choose **External Content**. 1. In **Setup**, enter the following details: - **Name**: A descriptive name for the token. - (Optional) **Category**: Create or assign a category. This helps you organize your tokens. The categories are shown in the **Personalization** sidebar when [editing your campaign](#use-the-tokens-in-an-emarsys-campaign). - **External Content preset**: Create or assign a [preset](#external-content-presets). - **Field**: The loyalty attribute to use in your Emarsys campaign. For example, to use the current loyalty point balance in your campaign, select `activeBalance`. 1. Click **Save**. Repeat the above steps for every attribute you want to use in your Emarsys campaign. ### Use the tokens in an Emarsys campaign Now, we can use the tokens we created in a campaign: 1. Open your Emarsys campaign for editing.In this tutorial, we'll use a **block-based email campaign**. 1. Go to the **Content Creation** step of the campaign creation wizard. 1. In the editor sidebar, open **Personalization** and find your created tokens in the **Custom Tokens** section. 1. Drag the desired tokens into the content editor window. 1. To test your email, use the **Testmail** feature. 1. Click **Finish Editing**. :::note When using the **Inbox Preview** feature, placeholders are displayed instead of the actual token values. ::: ## External Content presets To manage recurring loyalty requests to Talon.One, create an External Content preset and assign it to [your personalization token](#create-tokens-in-emarsys). See the [Emarsys docs](https://help.sap.com/docs/SAP_EMARSYS/f8e2fafeea804018a954a8857d9dfff3/fdf0b3af74c11014805bffc1fe88873a.html#creating-an-external-content-preset). :::note example Assume you want to retrieve information about a specific loyalty program in Talon.One. The ID of this program is `14`. Also, you want to use the customer's email address as the unique identifier to retrieve loyalty information. In this case, create the following preset and assign it to your token: - **Name**: A descriptive name for the preset. - **Connection**: The External Content connection you [created](#create-a-connection-in-emarsys). - **Parameters**: | Name | Type | Value | | ------------------ | ------------- | ------- | | `integrationId` | Contact Field | `Email` | | `loyaltyProgramId` | Constant | `14` | :::