Skip to main content

Authorization

Follow this guide to create a new Snapchat Ads credential that will allow Nexla to authenticate to and exchange data with your Snapchat Ads account.
snapads_api_auth.png

Snapchat Ads

Prerequisites​

Before creating a Snapchat Ads credential, you need to register an application in the Snapchat Ads Manager and obtain your Client ID and Client Secret. Snapchat Ads uses OAuth2 3-legged authentication for all API requests, requiring user authorization to obtain an access token.

To obtain your Snapchat Ads credentials, follow these steps:

  1. Sign in to your Snapchat Ads Manager account using your administrator credentials.

  2. Navigate to Tools in the top navigation menu, then select Snapchat Marketing API or navigate to Settings > Snapchat Marketing API.

  3. Look for the Applications or API Applications section in the Snapchat Marketing API settings.

  4. Click Create Application or Register New Application to create a new application for API access.

  5. Configure your application settings:

    • Enter a name for the application (e.g., "Nexla Integration")
    • Enter an application description (optional)
    • Review and select the permissions or scopes for the application:
      • Marketing API (snapchat-marketing-api): Allows the app to read and write to the Snapchat marketing APIs
      • Conversions API (snapchat-offline-conversions-api): Allows the app to read and write to the Snapchat Conversions APIs
      • Profile API (snapchat-profile-api): Allows the app to read the Snapchat Public Profile APIs
      • You can select multiple scopes or all three APIs

  6. Click Create or Register to create the application.

  7. After the application is created, you will be provided with your Client ID and Client Secret. Copy both credentials immediately, as the Client Secret may not be accessible again after you navigate away from the page.

  8. Store both credentials securely, as you will need them to configure your Nexla credential. The Client ID and Client Secret are sensitive information and should be kept confidential.

The Client ID and Client Secret are used in the OAuth2 3-legged authorization flow. During credential creation in Nexla, you will be redirected to Snapchat to authorize the application. After authorization, Snapchat will provide an access token that is used in the Authorization: Bearer {token} header for all API requests to the Snapchat Marketing API. The token authenticates your requests and grants access to Snapchat Ads resources based on the scopes you configured for your application. If your credentials are compromised, you should immediately revoke them in your Snapchat Ads Manager settings and generate new ones. For detailed information about registering applications, OAuth2 authentication, and available endpoints, refer to the Snapchat Marketing API documentation.

Create a Snapchat Ads Credential​

  • To create a new Snapchat Ads credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Snapchat Ads

SnapchatAdsCred.png

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

OAuth2 3-Legged Authentication​

Snapchat Ads uses OAuth2 3-legged authentication for all API requests. The Client ID and Client Secret are used to initiate the OAuth2 authorization flow, which requires user authorization to obtain an access token.

  1. Enter your Snapchat Ads Access Scope in the Access Scope field. This should be the scope(s) you configured for your application in Snapchat Ads Manager. Available scopes include:

    • snapchat-marketing-api: Marketing API access
    • snapchat-offline-conversions-api: Conversions API access
    • snapchat-profile-api: Profile API access
    • You can specify multiple scopes separated by commas (e.g., snapchat-marketing-api,snapchat-offline-conversions-api)

    The Access Scope determines which APIs your application can access. The default scope is snapchat-marketing-api.

  2. After entering your Access Scope, click Authorize or Connect to initiate the OAuth2 authorization flow. You will be redirected to Snapchat to authorize the application.

  3. Sign in to your Snapchat account if prompted, and review the permissions requested by the application.

  4. Click Authorize or Allow to grant the application access to your Snapchat Ads account.

  5. After authorization, you will be redirected back to Nexla, and the access token will be automatically configured for your credential.

    Your Snapchat Ads OAuth credentials can be found in your Snapchat Ads Manager under Tools > Snapchat Marketing API > Applications. The Client ID and Client Secret are generated when you create an application.

    These credentials are used to initiate the OAuth2 3-legged authorization flow. During credential creation, you will be redirected to Snapchat to authorize the application. After authorization, Snapchat will provide an access token that is used in the Authorization: Bearer {token} header for all API requests to the Snapchat Marketing API.

    If your credentials are compromised, you should immediately revoke them in your Snapchat Ads Manager settings and generate new ones. The credentials provide access to your Snapchat Ads account data and should be treated as sensitive information. Keep your credentials secure and do not share them publicly.

    For detailed information about registering applications, OAuth2 authentication, API scopes, and available endpoints, see the Snapchat Marketing API documentation.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.