Snapchat

Manage ads, campaigns, audiences, and reporting via the Snapchat Marketing API.

Detail	Value
Category	Social Media
Base URL	https://adsapi.snapchat.com/v1
Authentication	OAuth2
Endpoints	5
Connector key	snapchat

Using Snapchat in a workflow

1. Go to Connections and click New Connection.
2. Pick Snapchat from the marketplace.
3. Enter your credentials (see Authentication above for what's expected).
4. In a workflow, drop an API Call node and select this connection.
5. Pick the operation you need from the Operation dropdown. The full list is below.

Available endpoints

Endpoint	Summary
GET /me	Get authenticated user
GET /me/organizations	List organizations
GET /adaccounts/{adAccountId}/campaigns	List campaigns
POST /adaccounts/{adAccountId}/campaigns	Create a campaign
GET /adaccounts/{adAccountId}/stats	Get ad account stats

Each endpoint is documented in full below. Use the outline on the right to jump to one.

GET /me

Get authenticated user

Detail	Value
Operation ID	social.getMe
Method	GET
Path	/me

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Snapchat connection from the Connection dropdown.
3. In the Operation dropdown, select social.getMe.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Snapchat API reference.

GET /me/organizations

List organizations

Detail	Value
Operation ID	social.listOrganizations
Method	GET
Path	/me/organizations

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Snapchat connection from the Connection dropdown.
3. In the Operation dropdown, select social.listOrganizations.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Snapchat API reference.

GET /adaccounts/{adAccountId}/campaigns

List campaigns

Detail	Value
Operation ID	social.listCampaigns
Method	GET
Path	/adaccounts/{adAccountId}/campaigns

Parameters

Name	Location	Type	Required
adAccountId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Snapchat connection from the Connection dropdown.
3. In the Operation dropdown, select social.listCampaigns.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Snapchat API reference.

POST /adaccounts/{adAccountId}/campaigns

Create a campaign

Detail	Value
Operation ID	social.createCampaign
Method	POST
Path	/adaccounts/{adAccountId}/campaigns

Parameters

Name	Location	Type	Required
adAccountId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Snapchat connection from the Connection dropdown.
3. In the Operation dropdown, select social.createCampaign.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Snapchat API reference.

GET /adaccounts/{adAccountId}/stats

Get ad account stats

Detail	Value
Operation ID	social.getStats
Method	GET
Path	/adaccounts/{adAccountId}/stats

Parameters

Name	Location	Type	Required
adAccountId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Snapchat connection from the Connection dropdown.
3. In the Operation dropdown, select social.getStats.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Snapchat API reference.