# 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
- **Tools:** 21
- **Triggers:** 0
- **Slug:** `TONEDEN`
- **Version:** 20260211_00

## Tools

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

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

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