---
title: "Configure an App"
slug: "configure-an-app"
updated: 2025-10-30T22:31:14Z
published: 2025-10-30T22:31:14Z
canonical: "help.gladly.com/configure-an-app"
---

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

# Configure an App

## Configuring an app

> [!CAUTION]
> Secure API Tokens
> 
> - Do not store API Token information directly in App Platform files, or pass token information from one function to another (e.g., short-lived tokens).
> - Do not pass API Token information or elicit for that information via Guides.
> 
> See [Non-Oauth apps](https://help.gladly.com/developer-tutorials/docs/configure-an-app#nonoauth-apps) to learn how how external app secrets should be uploaded via the appcfg CLI and how to register an OAUTH App.

## Glossary

As you will run below commands, it will be important to understand the following terms and how they will be used.

`application identifier` - e.g. [gladly.com/shopify/v2.0.7](http://ela.com/shopify/v2.0.7)

`--name` - this shows up in the UI and should have a helpful name. For example “Shopify Dev Store v3.0.4”. This name informs: what app it is, to which instance of the app the configuration connects to, which version of the app it is.

`--activate` - set this to true if you wish to immediately enable this configuration to begin servicing requests

## Configure your app

#### Non-Oauth apps

```bash
appcfg apps config create <application identifier> \
--name "My Configuration" \
--config '{"non-secret":"configuration", "host":"www.example.com"}' \
--secrets '{"a-secret":"api-token"}' \
--activate
```

> [!NOTE]
> Tip
> 
> The `—config` flag is required even if the configuration is empty

Now an instance of the external app has been associated with the required configuration (such as API token stored on the configuration), and is officially ready for use. You can verify this by running the `appcfg apps config list` command:

```bash
appcfg apps config list                                                                                                                                                                         ✘ 1 
|     APP IDENTIFIER     |       CONFIG ID        |      CONFIG NAME      | CONFIG ACTIVE |  CONFIG CREATED AT  |  CONFIG UPDATED AT  |
|------------------------|------------------------|-----------------------|---------------|---------------------|---------------------|
| gladly.com/SKIO/v1.0.0 | YQ5YcTTVTPi5M3OAE0n6cA | Skio Partner Org v1.0 | Yes           | 2025-04-24 14:36:56 | 2025-04-24 14:36:56 |
|------------------------|------------------------|-----------------------|---------------|---------------------|---------------------|
```

### Oauth

> [!WARNING]
> Registering your Oauth domain
> 
> Make sure that have contacted Gladly Support to register your Oauth domain before running the command below

1. #### Create configuration

```bash
appcfg apps config create <application identifier> /
--name "My Configuration" /
--config '{"non-secret":"configuration"}'
--secrets '{}'
```
2. #### Authorize

```plaintext
appcfg apps oauth "My Configuration"
```

> [!NOTE]
> Autocomplete
> 
> With autocomplete, hit Tab after `appcfg apps config create`, and it will pull up all installed apps that are ready for configuration. The list will filter on partial matches, i.e. typing the identifier partially:
> 
> ```bash
> > appcfg apps config create <hit tab>
> App Platform Team/errors/v1.0.0         gladly.com/big_commerce/v1.0.8          gladly.com/big_commerce/v6.0.0          gladly.com/developer/v1.1.4             gladly.com/shopify/v1.0.3
> gladly.com/big_commerce/v1.0.10         gladly.com/big_commerce/v1.0.9          gladly.com/big_commerce/v8.0.0          gladly.com/install-test-epsilon/v1.0.0  gladly.com/shopify/v1.0.4
> gladly.com/big_commerce/v1.0.3          gladly.com/big_commerce/v2.0.0          gladly.com/developer/v1.0.0             gladly.com/install-test-epsilon/v1.2.4  gladly.com/shopify/v2.0.7
> gladly.com/big_commerce/v1.0.4          gladly.com/big_commerce/v3.0.0
> ```

## Updating config/Activate config

When you run `appcfg apps config list` you will see a column CONFIG ID, which can be used to activate your configuration when you are ready:

To activate:

```bash
appcfg apps config update <config-id> --activate
```

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![hamburger-menu-icon(1)](https://cdn.us.document360.io/7047b671-c4f2-4df0-bb0a-b9b511fd2452/Images/Documentation/hamburger-menu-icon(1).svg?sv=2026-02-06&spr=https&st=2026-10-31T12%3A43%3A27Z&se=2026-10-31T13%3A43%3A27Z&sr=c&sp=r&sig=s785BBY7r5tHGynq3vXH0YcuwuicVblprTfx%2B9mVqt8%3D)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.