Toneden

26 tools available

ToneDen automates social media campaigns, advertising, and landing pages, particularly for music promoters and event organizers looking to boost audience reach

social media marketing marketing automation

Connect Toneden Visit Toneden ↗

Connect Toneden to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Toneden's 26 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.

Common workflows with Toneden

Trigger on event

Listen for a new event
Parse and validate the payload
Take an action with the linked tool

Daily summary

Pull yesterday's activity
Summarise with the model of your choice
Send the digest via email or Slack

Cross-tool sync

Read records from one app
Transform with a persona
Write the result back via this integration

Toneden actions 26

Every Toneden action below is a callable tool any Definable persona can invoke.

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 Advertising Campaign

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

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

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

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

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.

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.

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

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.

Frequently asked questions

What can I automate with Toneden on Definable?

Anything Toneden exposes through its API. Common social media marketing workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 26 Toneden tools directly, then chain the result into another integration without you writing code.

How does Toneden authentication work?

Toneden uses API_KEY, OAUTH2 on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Toneden integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 26 Toneden tools. You only need a separate Toneden subscription if Toneden itself charges per seat or per API call.

Is using Toneden through Definable secure?

Every call from a persona to Toneden is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Toneden on Definable?

Sign up for Definable, open the integrations page, find Toneden, and connect via OAuth or API key. You can immediately attach Toneden to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Toneden actions does Definable expose?

Definable exposes all 26 Toneden actions as callable tools — including `Create Advertising Campaign`, `Create Attachment`, `Create ToneDen Link`, plus 23 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Toneden?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations