N8N Tools Snapchat icon

N8N Tools Snapchat

Interact with Snapchat API

Actions42

Overview

This node enables interaction with the Snapchat Ads API, specifically supporting various resources such as Ads, Campaigns, Creatives, Audiences, Pixels, Webhooks, and Reports. For the Creatives resource, it supports operations including uploading creative assets.

The Upload Creative Asset operation allows users to upload media assets (such as images or videos) to be used in Snapchat ad creatives. This is useful when building or updating ad creatives that require custom media content.

Practical examples:

  • Uploading a new image or video asset to be associated with a Snapchat ad creative.
  • Automating the process of managing creative assets within an advertising workflow.
  • Integrating Snapchat creative asset uploads into larger marketing automation pipelines.

Properties

Name Meaning
Ad Account ID The unique identifier for the Snapchat Ad Account under which the creative asset is uploaded. This is required for all operations involving creatives.
assetData The actual data/content of the creative asset to upload (e.g., base64 encoded file content or binary data). (Note: This property is referenced in code but not provided in the user JSON; it must be supplied by the user.)
filename The name of the file being uploaded as the creative asset (e.g., "image.jpg", "video.mp4"). (Also referenced in code but not listed in user properties.)

Note: The last two properties (assetData and filename) are necessary for the "Upload Creative Asset" operation but were not included in the provided input properties JSON. They are inferred from the source code usage.

Output

The node outputs an array of JSON objects, each representing the result of the executed operation per input item.

For the Upload Creative Asset operation, the output JSON contains the response from the Snapchat API after uploading the asset. This typically includes metadata about the uploaded asset such as its ID, URL, status, or any other relevant information returned by the API.

If an error occurs during execution and the node is configured to continue on failure, the output JSON will contain an error field with the error message.

The node does not explicitly handle binary output for this operation.

Dependencies

  • Requires valid credentials for accessing the Snapchat Ads API, including an API key or OAuth2 token.
  • Requires configuration of an external API service ("N8N Tools API") for subscription validation before executing Snapchat API calls.
  • The node depends on the bundled snapchat-api module which abstracts Snapchat API endpoints.
  • Network access to https://adsapi.snapchat.com for Snapchat API requests.
  • Network access to the N8N Tools API endpoint for subscription validation.

Troubleshooting

  • Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correctly configured and active.
  • Unknown Operation Error: If an unsupported operation value is provided, the node will throw an "Unknown operation" error. Ensure the operation parameter is set to one of the supported values.
  • Missing Required Parameters: The operation requires adAccountId, assetData, and filename. Missing any of these will cause errors.
  • API Request Failures: Network issues or Snapchat API errors may cause failures. Check network connectivity and API limits.
  • JSON Parsing Errors: Some operations expect JSON strings for data parameters. Invalid JSON will cause parsing errors.

Links and References

Discussion