Reco

This guide will walk you through how to create an API integration with Reco by creating a Shopify app, get client id, client secret, app id and access token and connecting reco event bridge for audit logs requested for the integration

Go to the admin console of your Shopify account

Go to Configuration tab - and click configure on the Admin API integration box.

Configuring app scopes -  here we define the required scopes - choose the following:

1. read_apps
2. read_content
3. If you have Shopify Plus:
 1. read_users
 2. read_audit_events
 Click Save

1. scroll down untill you find the Amazon EventBridge card and open it 

2. click on Create source 

3. fill in the form
 1. AWS account ID should be provided from your reco POC
 2. AWS region should be provided from your reco POC
 3. source name should be "{{COMPANY_NAME}}-shopify-event-source" - this value will also be used in the reco integration
 4. click Create

4. in the main Configuration page, click Save

Extract the AppID from the application url:

1. the format should be: "admin.shopify.com/store/aaaaaa-aa/settings/apps/development/{{APP_ID}}/configuration/admin_api_integration"

IMPORTANT - Reco required the scopes read_users &amp; read_apps in order to get the data on accounts &amp; applications - this considered as sensitive scopes in Shopify and you will need to contact Shopify support to ask them to enable it for this integration.

Go to API credentials tab - you will find there

1. Admin API access token
2. API key
3. API Secret key

1. Go to the admin console of your Shopify account
2. Click Settings on the bottom left
3. Click Apps and sales channels

4. Click on Develop apps

5. Click Create an app

6. Give the app a name and click create app

7. Go to Configuration tab - and click configure on the Admin API integration box.

8. Configuring app scopes - here we define the required scopes - choose the following:
 1. read_apps
 2. read_content
 3. If you have Shopify Plus:
 1. read_users
 2. read_audit_events
 Click Save

9. Create event source for audit logs - 
 1. scroll down untill you find the Amazon EventBridge card and open it 
 
 2. click on Create source 
 
 3. fill in the form
 1. AWS account ID should be provided from your reco POC
 2. AWS region should be provided from your reco POC
 3. source name should be "{{COMPANY_NAME}}-shopify-event-source" - this value will also be used in the reco integration
 4. click Create
 
 4. in the main Configuration page, click Save
10. Extract the AppID from the application url: 
 1. the format should be: "admin.shopify.com/store/aaaaaa-aa/settings/apps/development/{{APP_ID}}/configuration/admin_api_integration" 
11. IMPORTANT - Reco required the scopes read_users &amp; read_apps in order to get the data on accounts &amp; applications - this considered as sensitive scopes in Shopify and you will need to contact Shopify support to ask them to enable it for this integration.
 

12. Go to overview tab and click install app
13. Go to API credentials tab - you will find there
 1. Admin API access token
 2. API key
 3. API Secret key
 Save those to integrate with Reco

14. Copy the Store URL under My Store