# Toneden ToneDen automates social media campaigns, advertising, and landing pages, particularly for music promoters and event organizers looking to boost audience reach - **Category:** social media marketing - **Auth:** API_KEY, OAUTH2 - **Composio Managed App Available?** Yes - **Tools:** 26 - **Triggers:** 0 - **Slug:** `TONEDEN` - **Version:** 20260414_00 ## Tools ### Create Advertising Campaign **Slug:** `TONEDEN_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 **Slug:** `TONEDEN_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 **Slug:** `TONEDEN_CREATE_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 Advertising Campaign **Slug:** `TONEDEN_DELETE_ADVERTISING_CAMPAIGN` Deletes a ToneDen advertising campaign by ID using DELETE /advertising/campaigns/{campaignID}. ### Delete ToneDen Link **Slug:** `TONEDEN_DELETE_LINK` Deletes a ToneDen link by ID using DELETE /links/{linkID}. ### Delete ToneDen Playbook Campaign **Slug:** `TONEDEN_DELETE_PLAYBOOK_CAMPAIGN` Deletes a ToneDen playbook campaign by ID using DELETE /playbooks/campaigns/{campaignID}. ### Expand ToneDen Link Template **Slug:** `TONEDEN_EXPAND_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 **Slug:** `TONEDEN_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 **Slug:** `TONEDEN_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 **Slug:** `TONEDEN_GET_ADVERTISING_CAMPAIGN_INSIGHTS` Retrieve performance insights for a specific advertising campaign using ToneDen's API. Endpoint: GET /advertising/campaigns/{campaignID}/insights. ### Get Attachment **Slug:** `TONEDEN_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 **Slug:** `TONEDEN_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 **Slug:** `TONEDEN_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 **Slug:** `TONEDEN_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 **Slug:** `TONEDEN_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 **Slug:** `TONEDEN_GET_LINK` Tool to retrieve a specific ToneDen link by its ID. Use when you need to fetch details about an existing link. ### Get Link Insights **Slug:** `TONEDEN_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 **Slug:** `TONEDEN_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. ### Get ToneDen User **Slug:** `TONEDEN_GET_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. ### List ToneDen Playbook Campaigns **Slug:** `TONEDEN_LIST_PLAYBOOK_CAMPAIGNS` Tool to list playbook campaigns. Use when you need to retrieve a paginated list of all playbook campaigns. ### List User Attachments **Slug:** `TONEDEN_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 **Slug:** `TONEDEN_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 **Slug:** `TONEDEN_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 Playbook Campaign **Slug:** `TONEDEN_UPDATE_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. ### Update ToneDen User **Slug:** `TONEDEN_UPDATE_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 **Slug:** `TONEDEN_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.