Snapchat Extract authentication guide

Overview

This is a step-by-step guide to creating an OAuth entry, acquiring credentials and authorising the Snapchat Extract connector for use in Matillion ETL.

Important Information

• The Snapchat Extract connector uses an OAuth for third-party authentication.
• While connector properties may differ between Cloud Data Warehouses, the authentication process remains the same.

---

Creating an OAuth Entry in Matillion ETL

1. Navigate to the Snapchat Business portal. The Snapchat login screen will appear immediately. Enter valid login credentials to continue. then, verify the reCAPTCHA security check to continue. The browser will then be redirected you to the Snapchat dashboard. click Business Details on the sidebar on the left of the screen.

2. In Matillion ETL, on the top left corner of the screen, click Project → Manage OAuth.

   Please Note

   If a Snapchat Extract connector has already been added to an Orchestration Job, the Manage OAuth window may also be accessed using the following method:

   1. Click the connector icon to open the Properties panel at the bottom of the screen.
   2. Click ... next to the Authentication input, and finally click Manage in the pop-up window.
   

   Project dropdown menu

3. Copy the Callback URL in the field at the top of the window as this will be required in Acquiring Third-Party Credentials.

4. Click + in the bottom left corner of the window to open the Create OAuth Entry window.

   

   New OAuth Entry

5. Click on the Service dropdown menu and select Snapchat. Then, provide a name for the OAuth in the Name field and click OK.

   

   Create OAuth Entry window

6. On returning to the Manage OAuth window, check the list of OAuths to ensure the new entry is listed.

   Please Note

   This entry is Not Configured. Configuration of the OAuth entry will be discussed in Authorising for use in Matillion ETL.

   

   New Entry listed on Manage OAuth window

---

Acquiring Third-Party Credentials

1. Navigate to the Snapchat Business portal. The Snapchat login screen will appear immediately. Enter valid login credentials to continue. Snapchat may request a reCAPTCHA security check before moving on to the next step. The browser will then be redirected you to the Snapchat Business dashboard. Click Business Details on the sidebar on the left of the screen.

2. In the Business Details window, scroll down to the OAuth Apps section and click + OAuth App.

   

   Create an OAuth App

3. The Create OAuth App page will then open. Next, provide details for the following fields:

   • App Name – provide the name for OAuth App of your choice
   • Snap Redirect URI – paste the Callback URL (copied earlier from the Manage OAuth window in Matillion ETL), then click Save

   Please Note

   Users are limited to a maximum of 10 OAuth apps per account. If an error message is displayed after clicking Save, an existing OAuth app may need to be deleted before a new OAuth app can be created.

   

   Provide app details

4. If the new Oauth app is created successfully, the page will refresh and a message stating, "Success!" will appear in the top right corner of the screen. The Snap Client ID and a yellow block containing the Snap Client Secret Key will also appear at the bottom of the Create OAuth App block. Copy the codes from both the Snap Client ID and Snap Client Secret Key fields, as they will be required in Authorising for Use in Matillion ETL.

   Please Note

   • Make sure to copy the Secret Key right away as it will appear only once.
   • Additionally, when copying the codes, some browsers may add a space to the end of the code. Watch out for this as it will cause the credentials to fail.
   

   Copy the Snap Client ID and Secret Key

---

Authorising for Use in Matillion ETL

1. Return to the Manage OAuth window on Matillion ETL and click ⚙ next to the previously created OAuth entry. This will open the Configure OAuth window.

   

   Manage OAuth

2. Using the codes copied from the Snapchat Business portal earlier, provide details for the following fields:

   • Client ID – enter the Snap Client ID
   • Client Secret – enter the Snap Client Secret Key, then click Next
   

   Configure OAuth settings

3. The next window will have an Authorization Link. Click the link to authorise Matillion ETL to use the acquired credentials.

   

   Authorization Link

4. The browser will then redirect to a Snapchat screen requesting access to several account features. Click Continue to confirm.

   

   Allow access to Snapchat account

5. If all is successful, the browser will return to Matillion ETL with a window stating, "Authorization Successful".

   

   OAuth Authorization successful