Set up credentials
Open the Develop apps area
In your Shopify admin, go to Settings > Apps and sales channels > Develop apps.
Enable custom app development
If prompted, click Allow custom app development and confirm. This is a
one-time action per store and requires the store owner or a staff account
with the right permissions.
Create the app
Click Create an app, give it a name (for example, “Adapt”), select an
app developer, and click Create app.
Configure Admin API scopes
Open the Configuration tab, then under Admin API integration click
Configure. Select the read scopes you need, such as
read_orders,
read_products, and read_customers, then click Save.Install the app
Open the API credentials tab and click Install app, then confirm.
Installing the app generates the Admin API access token.
Reveal and copy the access token
Under Admin API access token, click Reveal token once and copy the
value. It starts with
shpat_. Shopify shows this token only one time, so
store it securely.Shopify is migrating new app creation to the Dev Dashboard and Shopify CLI.
The Develop apps flow in the admin remains available on many stores where
custom app development is enabled and is what produces a long-lived
shpat_
Admin API access token. If you do not see this option, create the app from the
Dev Dashboard instead.Connect to Adapt
Add your credentials
Enter the values you gathered above, then click Add connection:
You can rename the connection and choose whether it is shared with your
organization or kept personal to you.
| Secret Name | Value |
|---|---|
SHOPIFY_STORE_DOMAIN | Your store domain (e.g. my-store.myshopify.com) |
SHOPIFY_ADMIN_ACCESS_TOKEN | Your Admin API access token |
Security
- Credentials are encrypted at rest with AES-256
- Grant only the read scopes you need when configuring Admin API access
- The Admin API access token is shown only once at install time; store it securely
- Uninstalling or deleting the custom app revokes the token
- Never share your access token or commit it to source control