# Shopify

#### Setting Up a Shopify Partner Account

**Sign Up or Log In**: If you haven’t already, go to the [Shopify Partners page](https://partners.shopify.com) and sign up for an account. If you have an account, just log in.

#### Create a New App

**Create a New App**: Once logged in, navigate to the "Apps" section using the dashboard menu. Click on "Create app" to get started, select the "Create app manually"

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-69cf04673b6a071431be33c77bb1182eef2e851f%2Fshopify_img_5.png?alt=media" alt=""><figcaption></figcaption></figure>

Note the `clientId` and `clientSecret`. Next, click on the "Choose distribution"

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-16ae94113fc5bdcce4191c25598054c9a44f6f1e%2Fshopify_img_6.png?alt=media" alt=""><figcaption></figcaption></figure>

Select the "Public distribution" option

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-e6cc804aa607cb6d1d370917329eb34f648cee67%2Fshopify_img_7.png?alt=media" alt=""><figcaption></figcaption></figure>

Go to the "Configuration" section from the main menu

* set the Redirect URI to `https://[YOUR_API_BASE]/auth/twitter/callback`, for example `https://api.appmixer.com/auth/titter/callback`
* event version to the latest (2024-01)
* Embed app in Shopify admin: `false`
* set the compliance webhooks (it's required for the submission)
  * Customer data request endpoint: `https://[YOUR_API_BASE]/plugins/appmixer/shopify/customers/data_request`
  * Customer data erasure endpoint: `https://[YOUR_API_BASE]/plugins/appmixer/shopify/customers/redact`
  * Shop data erasure endpoint: `https://[YOUR_API_BASE]/plugins/appmixer/shopify/shop/redact`
*

![](https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-b1d7dbd10b9b9918d567da085e0bb7f4205e27e4%2Fshopify-2.png?alt=media)

Go to the "API Access" section from the main menu. In the "Access requests" request access for the "Protected customer data access" Fill details in the "Select your data use and reasons" section:

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-088ba9f7374c605ef8e5b4b484238f72ce5c0d42%2Fshopify_img_8.png?alt=media" alt=""><figcaption></figcaption></figure>

Fill the form in the "Provide your data protection details" section:

<figure><img src="https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-f1cb40f5a4035d8313114c9862d51f684436fd2c%2Fshopify-data-protection.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Configuration in the Backoffice

* Configure the App Key as `clientId` and the App Secret as `clientSecret` in the service settings within the Backoffice, under the configuration ID `appmixer:shopify`. Also, add the `appStoreInstallRedirectUri` pointing to your instance, for example `https://my.master-hamster-87765.appmixer.cloud/`
* To learn more about configuring connectors, please visit the [Connector Configuration](https://docs.appmixer.com/appmixer/getting-started/services) section.

**Please note that only a 'developer' shop instance can be authenticated with your OAuth application unless your app is verified. 'Production' shop instances cannot authenticate with an unverified app. This guide does not cover all the requirements for the app verification process.**
