Snapchat Marketing

Overview

The Snapchat Marketing source can sync data from the Snapchat Marketing API
Useful links:

Output schema

This Source is capable of syncing the following Streams:

Data type mapping

Integration Type
Airbyte Type
Notes
string
string
integer
integer
number
number
array
array
object
object
boolean
boolean

Features

Feature
Supported?
Full Refresh Sync
Yes
Incremental - Append Sync
Yes
Namespaces
No

Requirements

    client_id - Snapchat account client ID
    client_secret - Snapchat account client secret
    refresh_token - Snapchat account refresh token

Setup guide

To get the required credentials you need to set up a snapchat business account. Follow this guide to set up one:
Snapchat uses OAuth2 authentication, so to get the refresh token the workflow in next: 1. Open the authorize link in a browser: https://accounts.snapchat.com/login/oauth2/authorize?response_type=code&client_id={client_id}&redirect_uri={redirect_uri}&scope=snapchat-marketing-api&state=wmKkg0TWgppW8PTBZ20sldUmF7hwvU
    1.
    Login & Authorize via UI
    2.
    Locate "code" query parameter in the redirect
    3.
    Exchange code for access token + refresh token
    1
    curl -X POST \
    2
    -d "code={one_time_use_code}" \
    3
    -d "client_id={client_id}" \
    4
    -d "client_secret={client_secret}" \
    5
    -d "grant_type=authorization_code" \
    6
    -d "redirect_uri=redirect_uri"
    7
    https://accounts.snapchat.com/login/oauth2/access_token
    Copied!
You will receive the API key and refresh token in response. Use this refresh token in the connector specifications. The useful link to Authentication process is here

Performance considerations

Snapchat Marketing API has limitations to 1000 items per page

Changelog

Version
Date
Pull Request
Subject
0.1.0
2021-07-26
4843
Initial release supporting the Snapchat Marketing API
0.1.1
2021-07-29
5072
Fix bug with incorrect stream_state value
Last modified 2mo ago