---
title: "Smile App Platform Installation"
slug: "smile-app-platform-installation"
updated: 2026-08-26T05:00:00Z
published: 2026-08-26T05:00:00Z
canonical: "help.gladly.com/smile-app-platform-installation"
---

> ## 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.

# Smile App Platform Installation

The Smile app is set up entirely from Gladly’s Settings, no command-line tools are required. Once set up, your team can review loyalty data, and use any merchant-enabled actions, directly within Gladly.

### Step 1: Open the Apps settings

In Gladly, go to **Settings > Apps**. This is where you manage your App Platform integrations.

### Step 2: Create a configuration

Click the **Create Configuration** button. When prompted for the **External App**, choose the Smile app (`gladly.com/smile/v1.0.2`).

### Step 3: Fill in the configuration fields

Read-only loyalty data needs only the Smile API key below. Write actions stay off until you enable them and set both spending limits. Complete the fields in the configuration form:

- **Enable write actions** — allows agents to adjust points and purchase rewards in Smile. Leave off for a read-only rollout; turn on only after the actions are registered and tested against a disposable Customer.
- **Maximum point adjustment** — the largest number of points an agent may add or remove in one adjustment. Required when write actions are on; adjustments are blocked until it’s set.
- **Maximum point spend** — the largest number of points an agent may spend on one reward purchase. Required when write actions are on; purchases are blocked until it’s set.
- **Smile API key** — starts with `api_`. See Creating the Smile API key below.

![Configuration settings for integrating Gladly with the Smile loyalty program.](https://cdn.us.document360.io/7047b671-c4f2-4df0-bb0a-b9b511fd2452/Images/Documentation/smile integration.png?sv=2026-02-06&spr=https&st=2026-11-05T17%3A42%3A17Z&se=2026-11-05T18%3A42%3A17Z&sr=c&sp=r&sig=wtdMoZuNGMlxxfkZ4JSwhxSPd6InlY2y%2BwMdUB3vGmI%3D)

### Creating the Smile API key

API access is available on Smile’s **Plus and Enterprise** plans. In Smile Admin, go to **Settings > Developer tools**, find the **Manage API keys** card, and select **Generate new API key**. Name the key after this integration and grant the seven read scopes the card needs — customer:read, points_transaction:read, reward_fulfillment:read, points_product:read, earning_rule:read, points_settings:read, and vip_tier:read — plus a write scope only for an action you enable: points_transaction:write for Adjust points, or points_purchase:write for Purchase reward. Select **Generate** and copy the key immediately; Smile shows it only once.

## Contact Support

Users assigned the **Team Manager** or **Administrator** roles can contact [Gladly Support](https://help.gladly.com/product-docs/pages/en/contact-gladly-support-team). Log into Gladly as one of these roles, click the hamburger menu on the top-left corner, then click **Contact Gladly Support**. Gladly Support’s primary operating hours are Monday through Friday, 6 AM to 6 PM Pacific Time, but you can submit a request anytime.

- Please select the correct business impact (P1 to P4).
- Most requests should be sent as a P4.

*Customer* or C*ustomers* refers to the people you support through Gladly who buy or use your products or services.