Connect Toneden to your AI agent
ToneDen automates social media campaigns, advertising, and landing pages, particularly for music promoters and event organizers looking to boost audience reach
We set up the connection using your own Toneden account, with keys you control, and keep it running. Your agent picks it up and starts doing the work.
Actions
What your agent can do in Toneden
Each one is a real action the agent can take on its own, the same things a person clicking around Toneden could do. Read-only by default; write actions are confirmed against your policy.
- 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 typ…
- 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 m…
- 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 of…
- 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 compos…
- 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.
Setup
How we connect it
- 1
Connect your account
You create a key in Toneden, a key you create and control, and paste it in once. It lives in a secrets store on your server, not with us.
- 2
Set the guardrails
Read-only by default. You choose which write actions the agent may take, and anything outside that policy gets confirmed with you first.
- 3
We keep it running
Health checks on every connection, updates handled for you, and we watch the first week of activity to make sure the work lands.
FAQ
Toneden questions, answered.
With a key you create and control. You paste it in once, it is stored in a secrets store on your server, permissions are scoped to the minimum the agent needs, and you can revoke it at any time.
The actions Toneden's API allows, the same things a person clicking around the app could do. Connections start read-only by default; write actions are confirmed against the policy you set before the agent takes them.
Connections are priced per tool on top of the base plan. Some are included, some are premium. See pricing for how connection charges work.
Standard tools are ready inside 7 business days of the setup call. We test the connection end to end, walk you through how the agent uses it, and watch the first week of activity.
Ready to put Toneden to work?
Tell us what your team runs on. We set up the connection, secure it, and your agent takes it from there.
All product names, logos, and brands are property of their respective owners; used for identification only. ZeroToClaw is not affiliated with or endorsed by Toneden.