Install and Configure the Phoenix App in Shopify

To connect your Shopify store with Phoenix, you must create and configure a custom app inside your Shopify Admin.

All steps in this guide are completed inside your Shopify Admin.

This app allows Shopify and Phoenix to communicate securely and ensures the correct permissions are granted for the integration. Once configured and installed, the app generates the credentials required to complete the connection inside Phoenix.

This guide walks you through the complete setup process, from creating the app to retrieving your store credentials.

Prerequisites

Before you begin, ensure that you have:

• Shopify Admin access.

• The required App URL and API scopes provided below.

Create the Phoenix App

The first step is to create the custom Phoenix app inside Shopify. This app will later generate the credentials used to connect your store in Phoenix.

To create the app:

1. Log in to your Shopify Admin.

2. Go to Settings.

3. Select the Apps option to access installed and available applications for your store.

4. Click Develop apps to access app development tools.

5. Click Build apps in Dev Dashboard.

   Permissions Required

   If you don't have the required permissions, the Build apps in Dev Dashboard option will not be available. Instead, you may only see a Learn more option. Contact your Shopify administrator to request the necessary access.

6. Click Create app.

7. Enter the app name exactly as provided by Phoenix (for example, PHX 3.0).

8. Click Create.

After clicking Create, Shopify opens the Create a version screen. This is where you configure the app’s URL and permissions.

Configure Permissions and Secret Key

Before the app can be activated, you must define how it connects to Phoenix and what permissions it will have inside your store.

In this step, you will enter the App URL and the API scopes provided below.

To configure the app:

1. In the App URL field, paste the following URL:

   https://75eka897ja.execute-api.us-west-1.amazonaws.com/Prod/?secret=
   App URL Accuracy

   Make sure the URL matches the document exactly. Even small differences can prevent Shopify and Phoenix from communicating correctly.

2. In the Scopes field under the Access section, paste the following complete list of API scopes:

   read_all_orders,read_analytics,read_app_proxy,write_app_proxy,read_apps,read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_audit_events,read_customer_events,read_cart_transforms,write_cart_transforms,read_all_cart_transforms,read_validations,write_validations,read_channels,write_channels,read_checkout_branding_settings,write_checkout_branding_settings,write_checkouts,read_checkouts,read_companies,write_companies,read_custom_fulfillment_services,write_custom_fulfillment_services,read_custom_pixels,write_custom_pixels,read_customers,write_customers,read_customer_data_erasure,write_customer_data_erasure,read_customer_payment_methods,read_customer_merge,write_customer_merge,read_delivery_customizations,write_delivery_customizations,read_price_rules,write_price_rules,read_discounts,write_discounts,read_discounts_allocator_functions,write_discounts_allocator_functions,read_discovery,write_discovery,write_draft_orders,read_draft_orders,read_files,write_files,read_fulfillment_constraint_rules,write_fulfillment_constraint_rules,read_fulfillments,write_fulfillments,read_gift_card_transactions,write_gift_card_transactions,read_gift_cards,write_gift_cards,write_inventory,read_inventory,write_inventory_shipments,read_inventory_shipments,write_inventory_shipments_received_items,read_inventory_shipments_received_items,write_inventory_transfers,read_inventory_transfers,read_legal_policies,write_legal_policies,read_delivery_option_generators,write_delivery_option_generators,read_locales,write_locales,write_locations,read_locations,read_marketing_integrated_campaigns,write_marketing_integrated_campaigns,write_marketing_events,read_marketing_events,read_markets,write_markets,read_markets_home,write_markets_home,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,read_metaobject_definitions,write_metaobject_definitions,read_metaobjects,write_metaobjects,read_online_store_navigation,write_online_store_navigation,read_online_store_pages,write_online_store_pages,write_order_edits,read_order_edits,read_orders,write_orders,write_packing_slip_templates,read_packing_slip_templates,write_payment_mandate,read_payment_mandate,read_payment_terms,write_payment_terms,read_payment_customizations,write_payment_customizations,read_pixels,write_pixels,read_privacy_settings,write_privacy_settings,read_product_feeds,write_product_feeds,read_product_listings,write_product_listings,read_products,write_products,read_publications,write_publications,read_purchase_options,write_purchase_options,write_reports,read_reports,read_resource_feedbacks,write_resource_feedbacks,read_returns,write_returns,read_script_tags,write_script_tags,read_shipping,write_shipping,read_content,write_content,read_store_credit_account_transactions,write_store_credit_account_transactions,read_store_credit_accounts,write_own_subscription_contracts,read_own_subscription_contracts,write_theme_code,read_themes,write_themes,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders,read_translations,write_translations,customer_read_companies,customer_write_companies,customer_write_customers,customer_read_customers,customer_read_draft_orders,customer_read_markets,customer_read_metaobjects,customer_read_orders,customer_write_orders,customer_read_quick_sale,customer_write_quick_sale,customer_read_store_credit_account_transactions,customer_read_store_credit_accounts,customer_write_own_subscription_contracts,customer_read_own_subscription_contracts,unauthenticated_write_bulk_operations,unauthenticated_read_bulk_operations,unauthenticated_read_bundles,unauthenticated_write_checkouts,unauthenticated_read_checkouts,unauthenticated_write_customers,unauthenticated_read_customers,unauthenticated_read_customer_tags,unauthenticated_read_metaobjects,unauthenticated_read_product_pickup_locations,unauthenticated_read_product_inventory,unauthenticated_read_product_listings,unauthenticated_read_product_tags,unauthenticated_read_selling_plans,unauthenticated_read_shop_pay_installments_pricing,unauthenticated_read_content
   API Scope Validation

   Paste the scopes exactly as provided. They must appear as a properly formatted comma-separated list. If Shopify displays a validation message, review the list to confirm it is complete and correctly formatted.

3. Click Release.

4. Click Release again to confirm the configuration.

The first version of the Phoenix app is now active.

Add the Secret Key to a New Version

After activating the initial version, you must generate and apply the secret key. This key allows Phoenix to authenticate securely with your Shopify store.

To add the secret key:

1. Go to Settings inside the app.

2. Locate the Secret key and click the copy icon.

3. Go to Versions.

4. Click Create version.

5. In the App URL field that contains ?secret=, paste your copied secret immediately after the equal sign.

   Example format: https://your-phoenix-url.com?secret=YOUR_SECRET_KEY

   Secret Key Placement

   Keep the original URL unchanged and add the secret value directly after ?secret=.

6. Click Release.

7. Click Release again to activate the updated version.

Your Phoenix app configuration is now complete.

Install the App and Retrieve Credentials

Installing the app activates it inside your Shopify store and generates the credentials required to complete the connection in Phoenix.

To install the app:

1. Go to Home inside the app.

2. Click Install app.

3. Select your store.

4. Click Install.

   After installation, the App Configuration screen displays your store connection details. When installation is successful, the status appears as Connected.

   Store Selection

   If you have access to multiple Shopify stores, make sure you select the correct store before installing the app. The app must be installed in the same store you plan to connect with Phoenix.

5. Double-click the Load credentials icon to display your API credentials.

6. Verify that the following credentials are visible:

   • Admin Access Token

   • Storefront Access Token

   • App Secret (Client Secret)

     Credential Naming

     In some references, the Admin Access Token may also be referred to as the API access token. These refer to the same credential.

These credentials will be entered during the Shopify APIs step when adding your store inside Phoenix.

Credential Security

The credentials generated in Shopify provide authenticated access to your store.

• Share credentials only through secure channels.

• Store API keys and tokens in protected environments.

• Limit access to authorized team members.

Related Guides

If you want to continue configuring your store and completing your Phoenix setup, review these guides:

• Connect Your Checkout to a Store and Gateway

• Create and Customize Your Checkout

• Set Up Conversion Pixels

• Create a Shopify Standard Checkout with Checkboxes