---
title: "Set Up Smile.io Integration"
slug: "set-up-smileio-integration"
description: "Learn how to connect Smile.io to Gladly. See integration information here."
updated: 2025-01-15T06:19:08Z
published: 2025-01-30T20:01:56Z
---

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

# Set Up Smile.io Integration

| **REQUIRED USER ROLE** Administrator | **PERMISSION OVERVIEW** [View permissions by role](https://help.gladly.com/docs/managing-users-and-roles#roles-and-responsibilities) |
| --- | --- |

## Before you start

Review the following information before you connect [Smile.io](https://Smile.io) to Gladly.

- This is a two-part configuration process that must be completed in sequential order. First, you must collect your Smile Private Key, then connect [Smile.io](https://Smile.io) to Gladly.

## Find Smile Private Key

1. Log into [smile.io](https://smile.io). You can log into Smile by following the **Apps** page in Shopify.
2. Navigate to [](https://app.smile.io/settings/platform)[https://app.smile.io/settings/platform](https://app.smile.io/settings/platform).
3. Click **Show more**. ![Shopify settings page displaying order reward configurations and account connection status.](https://cdn.us.document360.io/7047b671-c4f2-4df0-bb0a-b9b511fd2452/Images/Documentation/smile.io-private-key.png)
4. Here, you'll find your “Private Key,” which you will need when setting up [Smile.io](https://Smile.io) in Gladly. Copy this key. ![Private section with hidden content and options to reveal or copy information.](https://cdn.us.document360.io/7047b671-c4f2-4df0-bb0a-b9b511fd2452/Images/Documentation/smile-private-key-text.png)

Next, connect [Smile.io](https://Smile.io) to Gladly.

## Connect [Smile.io](https://Smile.io) to Gladly

From the [Apps](https://help.gladly.com/docs/add-new-integration) page, click **Add App > Smile**.

1. From the Add New Smile App page, enter the following information:
  - **Name –** Enter a name that will help you identify the Smile instance (e.g., Smile)
  - **Smile Private Token –** Enter the Smile Private Key you obtained from the above section.
  - **Search Query Attributes –**There are two columns (Attribute, Label) required for Search Query Attributes. The email/Email attribute is the only attribute you can use to look up Customers in Smile.
    - **Don't change** the Attribute column.
  - **Search Results Attributes –**There are two columns (Attribute, Label) required for Search Results.
    - The default Search Result Attributes are name/Name, email/Email, and externalCustomerId/Smile ID.
    - You can use any **Label** for each attribute that provides an Agent-friendly name for the attribute.
    - **Note –** If you require any additional attributes, please Contact [Gladly Support](https://help.gladly.com/product-docs/pages/en/contact-gladly-support-team).
  - **Auto-Linking Fields –**If a Customer Profile is not currently linked to a Smile instance, and if your Smile instance responds with a unique profile with at least one auto-linking field match and no conflicts, Gladly will automatically link the Profiles without any user intervention and populate the pulled information in the Customer Profile.
    - **Note –** *Customer Email* is currently the only option available that can be used to match a Customer Profile to a Smile instance. Check this box to allow [auto-linking](https://help.gladly.com/docs/automatically-link-customer-data) by email address.
  - **Overwrite Existing Values –** If activated and a Customer Profile is linked to a profile in Smile, Gladly will [overwrite](https://help.gladly.com/docs/automatically-link-customer-data/#h-customer-profile-data-refreshes-automatically) editable custom attributes in the Customer Profile with data from Smile.
  - Click **Save App**.