toneden

name	toneden
description	ToneDen API integration with managed OAuth. Create smart links, manage ad campaigns, track fan engagement, monitor social unlocks and contest entries. Use this skill when users want to promote music, create marketing links, run advertising campaigns, or analyze fan engagement metrics.

ToneDen

Music marketing and fan engagement from chat -- create smart links, run ad campaigns, track social unlocks, and analyze performance metrics.

Powered by ClawLink, an integration hub for OpenClaw that handles hosted OAuth flows and credentials so you don't need to configure ToneDen API access yourself.

Setup in 3 Steps

Step 1: Install	Step 2: Pair Account	Step 3: Connect ToneDen
		App-specific connection GIF coming soon
Run the install command in OpenClaw	Sign in and approve the device	Open the dashboard and connect ToneDen

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│  ToneDen API     │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start

1. Get your user profile: toneden_get_user -- verify your ToneDen connection.
2. Create a smart link: toneden_create_link -- generate a music, podcast, or event link.
3. Check link insights: toneden_get_link_insights -- view clicks and engagement metrics.

Authentication

ToneDen uses managed OAuth via ClawLink. No API keys needed. Connect your ToneDen account at claw-link.dev/dashboard?add=toneden and authorize access through the hosted flow.

Connection Management

List connections: clawlink_list_integrations -- confirm ToneDen is connected.

Verify: Call toneden_get_user to test access.

Reconnect: If you see auth errors, reconnect at claw-link.dev/dashboard?add=toneden.

Security & Permissions

Read operations (get links, insights, attachments) run safely without confirmation. Write operations (create, update) require confirmation. Delete operations are marked as high-impact and irreversible.

Tool Reference

Link Operations

Tool	Description	Mode
toneden_create_link	Create a smart link (music, podcast, event, tour, fundraiser, etc.)	Write
toneden_get_link	Retrieve a specific link by ID	Read
toneden_delete_link	Permanently delete a link	Write
toneden_expand_link_template	Expand a link template with tracking pixels and service links	Read
toneden_validate_link_path	Check if a link path/subdomain is unique and valid	Read

Link Insights

Tool	Description	Mode
toneden_get_link_insights	Get detailed metrics (clicks, clickthroughs, email clicks)	Read
toneden_get_link_insights_overview	Get aggregated metrics across platforms	Read

Advertising Campaign Operations

Tool	Description	Mode
toneden_create_advertising_campaign	Create an ad campaign on Facebook or Google	Write
toneden_get_advertising_campaign	Retrieve a specific campaign by ID	Read
toneden_delete_advertising_campaign	Permanently delete an ad campaign	Write
toneden_get_advertising_campaign_insights	Get performance insights for a campaign	Read
toneden_get_advertising_campaign_creative_insights	Get creative performance insights	Read

Attachment (Social Unlock) Operations

Tool	Description	Mode
toneden_create_attachment	Create a social unlock or contest attachment	Write
toneden_get_attachment	Retrieve an attachment by ID	Read
toneden_update_attachment	Update an existing attachment	Write
toneden_list_user_attachments	List all attachments for a user	Read
toneden_get_attachment_entries_time_series	Get time-series entry statistics	Read
toneden_get_attachment_entries_totals	Get aggregate entry counts	Read
toneden_get_attachment_unlocks_by_platform	Get unlock counts broken down by platform	Read
toneden_get_attachment_unlocks_time_series	Get time-series unlock statistics	Read

Playbook Campaign Operations

Tool	Description	Mode
toneden_list_playbook_campaigns	List all playbook campaigns	Read
toneden_update_playbook_campaign	Update a playbook campaign by ID	Write
toneden_delete_playbook_campaign	Permanently delete a playbook campaign	Write

User Operations

Tool	Description	Mode
toneden_get_user	Retrieve user profile information	Read
toneden_update_user	Update user profile details	Write
toneden_list_user_lists	List user's advertising custom audiences	Read

Code Examples

Create a music smart link

{
  "tool": "toneden_create_link",
  "args": {
    "target_type": "music",
    "url": "https://open.spotify.com/track/abc123"
  }
}

Get link performance insights

{
  "tool": "toneden_get_link_insights",
  "args": { "link_id": "link123" }
}

Create an advertising campaign

{
  "tool": "toneden_create_advertising_campaign",
  "args": {
    "platform": "facebook",
    "budget": 50,
    "name": "New Single Promo"
  }
}

Check attachment unlocks by platform

{
  "tool": "toneden_get_attachment_unlocks_by_platform",
  "args": { "attachment_id": "att456" }
}

Discovery Workflow

1. Call clawlink_list_integrations to confirm toneden is connected.
2. Call clawlink_list_tools --integration toneden to see the live catalog.
3. Call toneden_get_user to verify your account.
4. Use link and campaign tools to manage your music marketing.

Execution Workflow

Read Flow:  User asks for insights → clawlink resolves connection → ToneDen API → metrics displayed
Write Flow: User wants to create link → confirmation prompt → clawlink resolves connection → ToneDen API → link created

Notes

• Some accounts may not have advertising access; non-2xx responses are returned for observability.
• ToneDen's public docs do not expose the full request body schema for playbook campaign updates.
• Link types include: music, podcast, livestream, event, tour, biglink, fundraiser, smartlink, and custom.

Error Handling

Status / Error	Meaning
401 Unauthorized	Token expired; reconnect at the dashboard
403 Forbidden	Account lacks advertising access
404 Not Found	Invalid link, campaign, or attachment ID

Troubleshooting

Tools Not Visible

Run openclaw gateway restart after installing the plugin. Start a fresh chat session.

Advertising Access Denied

Verify your ToneDen plan includes advertising features. Some endpoints return non-2xx for accounts without ad access.

Resources

• ToneDen API Docs: https://www.toneden.io
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=toneden
• ClawLink Docs: https://docs.claw-link.dev/openclaw

---

Powered by ClawLink -- an integration hub for OpenClaw