Toneden

These are the Toneden actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

• Create Advertising Campaign

  Tool to create a ToneDen advertising campaign on Facebook or Google platforms. Use when you need to launch a new ad campaign with specified budget, targeting, and creatives.

• Create Attachment

  Tool to create an attachment. Use when you need to programmatically create a social unlock or contest attachment after gathering all required parameters.

• Create ToneDen Link

  Tool to create a ToneDen link. Use when you have the target_type and, if needed, the services array. Supports creation of links for music, podcast, livestream, event, tour, biglink, fundraiser, smartlink, and custom types.

• Delete ToneDen Link

  Deletes a ToneDen link by ID using DELETE /links/{linkID}.

• Delete ToneDen Playbook Campaign

  Deletes a ToneDen playbook campaign by ID using DELETE /playbooks/campaigns/{campaignID}.

• Get Link

  Tool to retrieve a specific ToneDen link by its ID. Use when you need to fetch details about an existing link.

• Get ToneDen User

  Tool to retrieve a specific ToneDen user by ID. Use when you need to fetch user profile information or details about the currently authenticated user.

• Update ToneDen Playbook Campaign

  Updates a ToneDen playbook campaign by ID using PUT /playbooks/campaigns/{campaignID}. Note: ToneDen's public docs do not expose the full request body schema for updates. This action sends a flexible JSON payload composed from provided fields and returns diagnostic information without raising on non-2xx responses, to aid real-world testing.

• Delete Advertising Campaign

  Deletes a ToneDen advertising campaign by ID using DELETE /advertising/campaigns/{campaignID}.

• Expand ToneDen Link Template

  Tool to expand a ToneDen link template. Use when you need to retrieve the full template link with your tracking pixels and optional service links. Provide a URL to generate platform services for music or podcast content.

• Get Advertising Campaign

  Retrieve a specific advertising campaign by its ID using ToneDen's API. Endpoint: GET /advertising/campaigns/{campaignID} Notes: - This endpoint does not require a userID in the path per official docs. - Some accounts may not have advertising access; in such cases, non-2xx responses are still returned here for observability instead of raising, so the caller can inspect the error object.

• Get Advertising Campaign Creative Insights

  Retrieve creative performance insights for a specific advertising campaign using ToneDen's API. Endpoint: GET /advertising/campaigns/{campaignID}/creativeInsights. Note: Endpoint uses camelCase `creativeInsights` per official docs.

• Get Advertising Campaign Insights

  Retrieve performance insights for a specific advertising campaign using ToneDen's API. Endpoint: GET /advertising/campaigns/{campaignID}/insights.

• Get Attachment

  Tool to retrieve an attachment by ID. Use when you need to fetch details of an existing attachment by its ID.

• Get Attachment Entries Time Series

  Tool to fetch time-series entry statistics for a specific attachment. Use when you need chronological entry data points for an attachment.

• Get Attachment Entries Totals

  Tool to fetch summary counts of entries for an attachment. Use when you need aggregate entry counts over day, week, month, and lifetime.

• Get Attachment Unlocks By Platform

  Tool to fetch counts of unlocks by platform for a specific attachment. Use when you need a breakdown of unlocks across platforms like Spotify, Twitter, etc.

• Get Attachment Unlocks Time Series

  Tool to fetch time-series unlock statistics for a specific attachment. Use when you need chronological unlock data points for an attachment.

• Get Link Insights

  Tool to retrieve detailed insights for a ToneDen link. Use when you have a link ID and need metrics such as clicks, clickthroughs, email clicks, etc.

• Get Link Insights Overview

  Tool to retrieve a summary overview of a link's performance insights. Use when you have a link ID and need aggregated metrics across platforms.

• List ToneDen Playbook Campaigns

  Tool to list playbook campaigns. Use when you need to retrieve a paginated list of all playbook campaigns.

• List User Attachments

  Tool to list attachments for a user. Use when you need to retrieve social unlocks or contest attachments belonging to a specific user.

• List User Lists

  Tool to retrieve a list of a user's advertising user lists. Use when you need to fetch all user lists (custom audiences) for a specific ToneDen user.

• Update Attachment

  Tool to update an existing attachment. Use when you need to flexibly modify any attachment field (or add custom fields) after its creation.

• Update ToneDen User

  Tool to update a ToneDen user's profile. Use when you need to modify user details (e.g., name, location, or settings) after fetching them.

• Validate Link Path

  Tool to check if a link path/subdomain combination is unique and valid. Use when creating or editing a ToneDen link to verify the path is available.