Skip to main content

Snapchat Ads

Snapchat Ads is a mobile advertising platform that enables businesses to create and manage advertising campaigns on Snapchat, reaching a young, engaged audience through various ad formats including video, AR lenses, and filters.

Snapchat Ads icon

Power end-to-end data operations for your Snapchat Ads API with Nexla. Our bi-directional Snapchat Ads connector is purpose-built for Snapchat Ads, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Snapchat Ads or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Snapchat Ads workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites​

Before creating a Snapchat Ads credential, you need to register an application in the Snapchat Ads Manager and obtain your Client ID and 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 secret. Copy both credentials immediately, as the 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 secret are sensitive information and should be kept confidential.

The Client ID and 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.

Authenticate​

Credentials required​

FieldRequiredSecretDescription
Access ScopeNoNoSnapchat Access Scope. Allowed values: Marketing API (This scope allows the app to read and write to the Snapchat marketing APIs); Conversions API (This scope allows the app to read and write to the Snapchat Conversions APIs); Profile API (This scope allows the app to read the Snapchat Public Profile APIs); Marketing, Conversions, and Profile APIs (This scope allows the app access to all three APIs)

Create a credential in Nexla​

  1. 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

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

  2. Snapchat Ads uses OAuth2 3-legged authentication for all API requests. 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.

  3. Click Authorize or Connect to initiate the OAuth2 authorization flow. You will be redirected to Snapchat to authorize the application. Sign in to your Snapchat account if prompted, and review the permissions requested by the application. Click Authorize or Allow to grant the application access to your Snapchat Ads account. 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 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.

  4. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source​

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Snapchat Ads connector tile, then select the credential that will be used to connect to your Snapchat Ads account, and click Next; or, create a new Snapchat Ads credential for use in this flow.

Endpoint templates​

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Snapchat Ads endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

Get all Organizations

This endpoint template retrieves all organizations from your Snapchat Ads account. Use this template when you need to retrieve information about organizations, including organization IDs, names, and other organization metadata.

  • This endpoint automatically retrieves all organizations from your Snapchat Ads account. No additional configuration is required beyond selecting this endpoint template.

This endpoint returns all organizations from your Snapchat Ads account, including organization IDs, names, and other organization metadata. Use this endpoint to discover available organizations for use with other endpoints.

For detailed information about organizations, API response structures, and available organization data, see the Snapchat Marketing API documentation.

Get all Ad Accounts

This endpoint template retrieves all ad accounts in an organization from your Snapchat Ads account. Use this template when you need to retrieve information about ad accounts, including ad account IDs, names, and other ad account metadata.

  • Enter the Organization ID in the Organization ID field. This should be the unique identifier of the organization whose ad accounts you want to retrieve. The Organization ID determines which organization's ad accounts will be retrieved. You can find the Organization ID by using the "Get all Organizations" endpoint. The endpoint uses next URL pagination to handle large datasets efficiently, returning up to 1000 records per page by default.

This endpoint returns all ad accounts in an organization from your Snapchat Ads account, including ad account IDs, names, and other ad account metadata. The endpoint uses next URL pagination with paging.next_link to handle large datasets efficiently. Nexla will automatically follow the pagination links to fetch subsequent pages of data.

The Organization ID can be found by using the "Get all Organizations" endpoint. For detailed information about ad accounts, API response structures, pagination, and available ad account data, see the Snapchat Marketing API documentation.

Get Daily Measurement Stats

This endpoint template fetches measurement stats for a campaign, ad, or ad account from your Snapchat Ads account. This template has granularity set to daily. Switch to advanced mode for customizing options.

  • Enter the Entity Type in the Entity Type field. This should be the type of entity for which you want to retrieve stats (e.g., campaigns, ads, adaccounts). The Entity Type determines which type of entity's stats will be retrieved.
  • Enter the Entity ID in the Entity ID field. This should be the unique identifier of the entity (campaign, ad, or ad account) for which you want to retrieve stats. The Entity ID determines which entity's stats will be retrieved.
  • Enter the Start Time in the Start Time field. This should be the start date and time for the stats period in ISO 8601 format (e.g., 2024-01-01T00:00:00Z). The Start Time determines the beginning of the stats period.
  • Enter the End Time in the End Time field. This should be the end date and time for the stats period in ISO 8601 format (e.g., 2024-01-31T23:59:59Z). The End Time determines the end of the stats period.

This endpoint fetches measurement stats for a campaign, ad, or ad account from your Snapchat Ads account. The endpoint uses next URL pagination with paging.next_link to handle large datasets efficiently. Nexla will automatically follow the pagination links to fetch subsequent pages of data.

This template has granularity set to daily. Switch to advanced mode for customizing options such as granularity, date ranges, and other measurement parameters. For detailed information about measurement stats, API response structures, pagination, and available stats data, see the Snapchat Marketing API documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration​

Snapchat Ads data sources can also be manually configured to ingest data from any valid Snapchat Ads API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Snapchat Ads API typically uses the GET method with the base URL https://adsapi.snapchat.com/v1/ (e.g., https://adsapi.snapchat.com/v1/me, https://adsapi.snapchat.com/v1/organizations). For the Response Data Path, use $.data[*] to extract all items from the data array, or $[*] to extract all items from the response array, depending on your endpoint. Pagination mechanisms vary by endpoint; configure the pagination type and parameters to match your endpoint's mechanism.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Snapchat Ads data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.

Use as a destination​

Click the + icon on the Nexset that will be sent to the Snapchat Ads destination, and select the Send to Destination option from the menu. Select the Snapchat Ads connector from the list of available destination connectors, then select the credential that will be used to connect to your Snapchat Ads account, and click Next; or, create a new Snapchat Ads credential for use in this flow.

Endpoint templates​

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common Snapchat Ads endpoints. Select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.

Create Campaigns

This endpoint template allows you to create campaigns in your Snapchat Ads account using records from a Nexset. Use this template when you need to automatically create campaigns based on data from your Nexla flows.

  • Enter the Ad Account ID in the Ad Account ID field. This should be the unique identifier of the ad account in which you want to create campaigns. The Ad Account ID determines which ad account will receive the new campaigns. You can find the Ad Account ID by using the "Get all Ad Accounts" data source endpoint.
  • This endpoint sends data as JSON in the request body to create new campaigns in your Snapchat Ads account. Each record from your Nexset will be sent as a separate API request to create a new campaign. The request body should contain the campaign data in the format required by the Snapchat Marketing API, including campaign name, objective, budget, and other campaign properties.

This endpoint sends data as JSON in the request body to create new campaigns in your Snapchat Ads account. Each record from your Nexset will be sent as a separate API request to create a new campaign. The request body should contain the campaign data in the format required by the Snapchat Marketing API, including campaign name, objective, budget, schedule, and other campaign properties.

The Ad Account ID can be found by using the "Get all Ad Accounts" data source endpoint. The campaign structure must match the Snapchat Marketing API's expected format. Please check the API documentation link for all required properties in the Nexset record.

For detailed information about campaign creation, request body formats, and available campaign properties, see the Snapchat Marketing API documentation.

Manual configuration​

Snapchat Ads destinations can also be manually configured to send data to any valid Snapchat Ads API endpoint. Manual configuration provides maximum flexibility for accessing endpoints not covered by pre-built templates or when you need custom API configurations. Using manual configuration, you can also configure Nexla to automatically send the response received from the Snapchat Ads API after each call to a new Nexla webhook data source. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, data format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks.

Snapchat Ads API typically uses the POST method with JSON format for creating resources, and the base URL https://adsapi.snapchat.com/v1/ (e.g., https://adsapi.snapchat.com/v1/adaccounts/{ad_account_id}/campaigns). The request body is typically {message.json} to send the entire Nexset data as JSON, with field names matching the Snapchat Marketing API's expected structure.

Save & activate​

Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To send the data to the configured Snapchat Ads endpoint, open the destination resource menu, and select Activate.

The Nexset data will not be sent to the Snapchat Ads endpoint until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.