Reference

Create Attachment

Attach social unlock or contest content to your Toneden campaigns, enabling you to require social sharing or engagement in exchange for access to gated content or prizes.

Get Attachment

Retrieve a specific attachment from your Toneden account using its ID to access file details, metadata, or content when needed in your marketing workflows.

Get Attachment Entries Time Series

Retrieves chronological data showing how many entries or interactions an attachment received over time, helping you understand engagement patterns and performance trends. This is useful for tracking the effectiveness of shared content across different time periods.

Get Attachment Entries Totals

Retrieves aggregate counts of entries for an attachment across different time periods (day, week, month, lifetime) to show how your content is performing. Use this to quickly understand engagement metrics without analyzing individual entries.

Get Attachment Unlocks By Platform

Retrieves the number of unlocks your attachment received on each platform, giving you visibility into which channels drive the most engagement with your content.

Get Attachment Unlocks Time Series

Retrieves unlock statistics over time for a specific attachment, showing when and how frequently your content was accessed. This helps you understand audience engagement patterns and content performance trends.

List User Attachments

Retrieves all attachments and social unlock files associated with a user account, helping you manage and track user-submitted content for campaigns.

Update Attachment

Modify an existing attachment's details, properties, or custom fields after it has been created, allowing you to keep your marketing assets up-to-date without recreating them.

Create Advertising Campaign

Launch a new advertising campaign on Facebook or Google with your chosen budget, targeting parameters, and creative assets to reach your audience.

Get Advertising Campaign Insights

Retrieve detailed performance metrics and insights for your advertising campaigns to understand their effectiveness and ROI. This helps you track what's working and make data-driven decisions about your marketing spend.

Delete Advertising Campaign

Removes an advertising campaign from your ToneDen account, allowing you to stop running promotions and clean up inactive campaigns. This helps you manage your marketing spend and eliminate outdated ads.

Get Advertising Campaign

Retrieve detailed information about a specific advertising campaign to monitor its performance metrics and settings. This helps you track campaign progress and access current campaign data whenever needed.

Get Advertising Campaign Creative Insights

Analyze how your ad creatives are performing in a specific campaign by retrieving detailed performance metrics and insights. This helps you understand which creative assets are driving engagement and ROI so you can optimize your advertising spend.

Create ToneDen Link

Generate shareable ToneDen links that direct audiences to your music, podcasts, events, or fundraisers across multiple streaming platforms and services simultaneously.

Get Link Insights

Retrieve detailed performance metrics for a ToneDen link including clicks, click-throughs, and email engagement data to measure campaign effectiveness.

Delete ToneDen Link

Remove a ToneDen link to clean up your music distribution and stop tracking a specific link's performance. This helps you manage outdated or underperforming links in your music marketing campaigns.

Expand ToneDen Link Template

Generates a complete ToneDen link from a template by adding your tracking pixels and service integrations, allowing you to share music or podcast content across multiple platforms simultaneously.

Get Link

Retrieve details about a ToneDen link using its ID, including analytics and configuration data. This helps you verify link settings and track performance without visiting the ToneDen dashboard.

Get Link Insights Overview

Retrieve aggregated performance metrics for a specific link across all platforms to understand how your shared content is performing overall.

Validate Link Path

Checks whether a specific link path or subdomain is available and valid before creating or updating a ToneDen link. This ensures your custom URLs are unique and ready to use without conflicts.

List User Lists

Retrieve all custom audiences and user lists associated with a ToneDen account to manage and review your existing audience segments.

List ToneDen Playbook Campaigns

Retrieve all your ToneDen playbook campaigns to see what promotional campaigns are running and their performance status. This helps you keep track of your music marketing efforts across all active playbooks.

Delete ToneDen Playbook Campaign

Remove a playbook campaign from your ToneDen account when you no longer need it or want to stop running that specific promotional strategy.

Update ToneDen Playbook Campaign

Modify an existing ToneDen playbook campaign's settings and content to optimize your music promotion strategy. This operation allows you to adjust campaign parameters without needing to create a new campaign from scratch.

Get ToneDen User

Retrieve detailed profile information for a ToneDen user, including account details and settings for the authenticated user.

Update ToneDen User

Modify your ToneDen user profile information such as name, location, bio, or account settings to keep your artist profile current and accurate.