> For the complete documentation index, see [llms.txt](https://doc.wearepatchworks.com/product-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/patchworks-connectors/shopify-prebuilt-connector/shopify-custom-app.md).

# Shopify Custom App

## Introduction

You can connect your Shopify Store to a Patchworks account via a custom app. This is very useful when you want to connect 1 Shopify store to multiple Patchworks Accounts.\
\
Only Users with the develop app permission are able to do, Patchworks cannot set this up for you as we do not have the correct access due to our partner account.\
\
Shopify instructions on how to create a custom app in your dev account can be found here\
[https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard\ <br>](https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard)To create a custom app go to the app settings in your store and click develop apps, if you have the correct permissions you should see a button to “Build Apps in Dev Dashboard”

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fm1gMU0FdOkQ3LTCitXcP%2Funknown.png?alt=media&amp;token=6ba2d6bc-6d97-48cd-a182-965079ad7a73" alt="" height="293" width="602">

<br>

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FYWKrzgUPczjhvsoSwSGQ%2Funknown.png?alt=media&amp;token=d9a95635-81a1-45df-a733-fc2bfaac0863" alt="" height="292" width="602">

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FNKWiYfxDPz6eDgobDy5E%2Funknown.png?alt=media&amp;token=7600d0d1-6f0a-49aa-8f19-837ef3313d9a" alt="" height="276" width="602">

\
When in the Dev Dashboard there is a button to create an app, click this and follow the instructions,

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FDQIJ3hkCdTSOqhWHKDaW%2Funknown.png?alt=media&amp;token=bd1a0858-be35-4bd3-9fca-273eaec08979" alt="" height="187" width="602">

\
\
The box for the scopes you can either go through and select only what you want the app to have access to or paste the following list in\
\
*`read_all_orders,read_assigned_fulfillment_orders,read_customers,read_delivery_customizations,read_discounts,read_draft_orders,read_fulfillments,read_gift_cards,read_inventory,read_locales,read_locations,read_markets,read_merchant_managed_fulfillment_orders,read_metaobject_definitions,read_metaobjects,read_order_edits,read_orders,read_payment_terms,read_price_rules,read_product_listings,read_products,read_publications,read_purchase_options,read_reports,read_returns,read_shipping,read_third_party_fulfillment_orders,write_assigned_fulfillment_orders,write_customers,write_delivery_customizations,write_discounts,write_draft_orders,write_fulfillments,write_gift_cards,write_inventory,write_locales,write_locations,write_markets,write_merchant_managed_fulfillment_orders,write_metaobject_definitions,write_metaobjects,write_order_edits,write_orders,write_payment_terms,write_price_rules,write_products,write_publications,write_purchase_options,write_reports,write_returns,write_shipping,write_third_party_fulfillment_orders,write_app_proxy,read_cart_transforms,write_cart_transforms,read_checkout_branding_settings,write_checkout_branding_settings,read_checkout_and_accounts_configurations,write_checkout_and_accounts_configurations,read_content,write_content,read_online_store_pages,read_customer_events,write_pixels,read_customer_merge,write_customer_merge,read_files,write_files,read_marketing_events,write_marketing_events,read_online_store_navigation,write_online_store_navigation,read_payment_customizations,write_payment_customizations,write_privacy_settings,read_privacy_settings,read_script_tags,write_script_tags,read_shopify_payments_disputes,read_shopify_payments_payouts,read_store_credit_accounts,read_store_credit_account_transactions,write_store_credit_account_transactions,read_themes,write_themes,read_translations,write_translations,read_validations,write_validations`*

This is the default list we use, however this covers everything, you may not want to allow access to all sections of the admin API\
\
Once you have entered all the details required release the app, this will bring up a client ID and Secret, make a note of these as you will require them when authenticating in Patchworks.\ <br>

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F9uU3l4DqIqNpCFpFiZdp%2Funknown.png?alt=media&amp;token=4b160bed-4dde-46c8-ae95-c3726f82f1d8" alt="" height="452" width="602">

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FaeT1SUyiJuVBeMTmy6AK%2Funknown.png?alt=media&amp;token=eede1525-b50f-433d-ade9-4ff2cf7f6e7b" alt="" height="275" width="602">

<br>

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F5Z6KqKCupGE5uW3Xd5AL%2Funknown.png?alt=media&amp;token=cc5dfd40-cdbe-4c62-a617-ebd2b826f111" alt="" height="419" width="602">

<br>

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fy4cHPyoQAmUvQFbzYrUx%2Funknown.png?alt=media&amp;token=9bccb6ec-e9b1-4e3b-a911-aca978a0766c" alt="" height="361" width="602">

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FC5tpzUrz9OwhhO3ASqrm%2Funknown.png?alt=media&amp;token=2dba7af7-ff8a-4b58-9bf0-9b334a0c9eb1" alt="" height="232" width="602">

Once you have released the app you then need to instal it on the stores required, If you have multiple stores you should see them all listed as available to install the app on

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FotNC41g6ogquhxnQF807%2Funknown.png?alt=media&amp;token=6fb67029-11ba-4ee1-bfbc-becc4b27d93f" alt="" height="296" width="602">

<br>

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FFQvH3z6WVLS2M5bU627s%2Funknown.png?alt=media&amp;token=d42ff26c-ef2b-442f-b362-6562607ee186" alt="" height="321" width="602">

<br>

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FmVxrB4P5Qn44MyUb0yG3%2Funknown.png?alt=media&amp;token=e7e4d8cd-529b-4b5c-8fe2-3b809a319e3c" alt="" height="323" width="602">

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FHqpxg8dgrrzQ0OvoUgDX%2Funknown.png?alt=media&amp;token=e17661ab-1fa9-4c4f-8802-77911a08966c" alt="" height="320" width="602">

Once this is all complete the next step is to create your instance within your Patchworks Account

<br>

Login to your patchworks account and install the Shopify app from the Marketplace\ <br>

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FEdmvbi6khGb8BLYsVlCO%2Funknown.png?alt=media&amp;token=50994f32-5618-4cad-996f-af6b4004b924" alt="" height="393" width="602">

<br>

\
\
After you have installed the Shopify connector, create an instance and enter the details as required,

<br>

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FR6RjZqKDxwHmHmtmh07J%2Funknown.png?alt=media&amp;token=119f3b9c-60d8-4796-a487-d1ab13ce0534" alt="" height="235" width="602">

<br>

This is where you will need the client ID and client secret from the previous steps and the store name you are connecting to.\ <br>

Enter a relevant name for your instance, we suggest using your store name.

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F3AjphiKmVsOGiwlw1mRJ%2Funknown.png?alt=media&amp;token=cf2f36ef-b31b-4372-bdd2-f95b60d4a285" alt="" height="479" width="602">

Select Custom App for the authentication&#x20;

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FZYqs6maZGDMumgRdM7he%2Funknown.png?alt=media&amp;token=ea1b189f-6eb2-4c1c-8378-c029df4009d9" alt="" height="581" width="602">

<br>

This next step is where you will need your Client Id and Secret from your custom app along with your store name which can be found in the Shopify Settings

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fenu8ZZzWfwFPNlvEpRgb%2Funknown.png?alt=media&amp;token=0194ae4b-7a87-47ff-b356-fed129a87f32" alt="" height="553" width="602">

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FkfLHt15yrwMCSOQYfZrl%2Funknown.png?alt=media&amp;token=69b10150-c356-4910-973c-52ddf8a08e32" alt="" height="394" width="373">

<br>

Once complete you will see an instance created with the custom app authentication method you can now use in your flows to connect to Shopify

<img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FxuRlXJ6UTHdtHFF62xco%2Funknown.png?alt=media&amp;token=822ad003-aa55-42da-ab42-dfda3c6b95fa" alt="" height="164" width="476">

\ <br>

<br>
