TokPortal
Article

How to Add TikTok Sounds via API: Native In-App Posting Explained

TokPortal is the only platform that lets you add TikTok sounds programmatically — because we post natively inside the app.

Vincent Tellenne

Vincent Tellenne

Founder & CEO

March 5, 20267 min read
How to Add TikTok Sounds via API: Native In-App Posting Explained
Share

Why TikTok Sounds Matter for Viral Content

Trending sounds are one of the most powerful distribution signals on TikTok. When a sound is trending, the algorithm actively pushes content using that sound to more users — creating a built-in amplification effect that can multiply your video's reach by 3-5x compared to original audio alone.

The reason is simple: TikTok's algorithm treats trending sounds as a content category in themselves. Users who engage with one video using a particular sound are likely to see more videos using the same sound. This creates a sound-driven discovery loop where your content can reach entirely new audiences who might never have found you through topic-based distribution alone.

For brands and marketers, sounds also add authenticity. Content that uses popular sounds feels native to the platform — it looks like something a real user would post, not an advertisement. This perception drives higher engagement rates and stronger algorithmic signals, compounding the distribution advantage.

The challenge? Until now, there was no way to add TikTok sounds programmatically. Official APIs and third-party posting tools can only upload video files — they can't access the sound library or overlay trending audio. This is where TokPortal changes everything.

90%

Of viral videos use trending sounds

3x

More engagement with sounds

API

Only via TokPortal

0-200%

Volume control range

How Native In-App Posting Works

Most TikTok automation platforms use TikTok's official Content Posting API to upload videos. This API is functional but extremely limited — it can upload a video file and set a caption, but it cannot add sounds, use editing features, set location tags, or create carousels. The official API essentially treats TikTok as a video hosting service, stripping away everything that makes content perform well on the platform.

TokPortal takes a fundamentally different approach. Instead of using the API, TokPortal posts content natively inside the TikTok app on real physical devices. This means your videos go through the exact same posting flow that a human user would use — opening the app, selecting a video, adding a sound from the library, adjusting volume levels, and publishing.

This native in-app approach unlocks features that are simply impossible through any API: adding sounds from TikTok's library, controlling the volume mix between original and added audio, creating carousel posts with sounds, using in-app editing features, and posting with location tags. The result is content that is indistinguishable from a manually posted video.

For marketers running multi-account campaigns, this is a game-changer. You can now programmatically manage hundreds of accounts while maintaining the full feature set that drives engagement and algorithmic distribution — including the trending sounds that are essential for viral content.

This Is Different from Every Other Platform

Every other TikTok automation tool uses the official API or browser automation, which cannot add sounds. TokPortal is the only platform that posts natively inside the TikTok app on real devices — giving you access to sounds, carousels with audio, volume controls, and other features that API-based tools simply cannot provide. This is not a workaround; it's a fundamentally different architecture.

Adding Sounds to Videos via API

add-sound.ts
// Configure a video with a TikTok sound and volume controls
const response = await fetch(
  'https://api.tokportal.com/v1/bundles/BUNDLE_ID/videos/1',
  {
    method: 'PUT',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      video_type: 'video',
      video_url: 'https://storage.example.com/my-video.mp4',
      description: 'Check out this transformation! #skincare #routine',
      target_publish_date: '2026-03-15',
      // Add a trending TikTok sound
      tiktok_sound_url: 'https://www.tiktok.com/music/trending-sound-7234567890',
      // Control volume mix (0-200 range)
      volume_original_sound: 30,   // Lower the original video audio
      volume_added_sound: 170       // Boost the trending sound
    })
  }
);

const video = await response.json();
console.log(`Video configured with sound: ${video.tiktok_sound_url}`);

The volume control system gives you precise mixing capabilities with two parameters: volume_original_sound controls the audio from your uploaded video file, while volume_added_sound controls the volume of the TikTok sound you've overlaid. Both accept values from 0 to 200, where 100 is the default volume level.

Setting volume_original_sound: 0 completely mutes your video's original audio, which is useful when your video has poor audio quality or when you want the trending sound to be the only audio. Conversely, setting volume_added_sound: 50 creates a subtle background music effect while keeping your video's dialogue or narration prominent.

Note that setting volume controls costs 1 credit per video when first configured. This is a one-time cost — you can adjust the values afterward without additional charges. If you don't set volume parameters, both default to 100 (original volume levels).

Finding the Right Sound URL

To add a sound via the API, you need the TikTok sound URL. This is the URL of the sound page on TikTok — it follows the format https://www.tiktok.com/music/sound-name-1234567890. You can find this URL from any video that uses the sound, or by browsing TikTok's sound library directly.

The sound URL is different from a video URL. When you find a video with a sound you want to use, you need to navigate to the sound page specifically — not just copy the video link. The sound page shows all videos using that particular audio, and its URL is what you'll pass to the API.

For campaign planning, it's worth building a library of sound URLs in your target niches. Track which sounds are trending in your space, monitor sound performance across your accounts, and rotate sounds to keep your content fresh. Sounds typically trend for 1-3 weeks, so having a rotation strategy ensures you're always using current audio.

1

Find a video using the sound you want

Open TikTok and find any video that uses the trending sound you want to add to your content. Tap the spinning record icon at the bottom-right of the video to navigate to the sound page.

2

Copy the sound URL

On the sound page, tap the share button and select 'Copy link.' On desktop, simply copy the URL from the browser address bar. The URL will look like: https://www.tiktok.com/music/sound-name-1234567890

3

Pass the URL to the TokPortal API

Use the tiktok_sound_url parameter when configuring your video through the API or dashboard. TokPortal will apply this sound natively when posting on the real device, just as a human user would.

Carousels with Sounds

TikTok carousels (photo mode posts) are one of the platform's fastest-growing content formats, and they require a sound to be posted. Unlike standard video posts where sounds are optional, carousel posts must include a TikTok sound — this is a platform requirement, not a TokPortal limitation.

Carousels are particularly popular for product showcases, step-by-step tutorials, before/after comparisons, and educational content. They often achieve higher save rates than video content because users bookmark them for reference, and the algorithm treats saves as a strong positive signal.

Because carousels require sounds and sounds can only be added via native in-app posting, TokPortal is the only way to create TikTok carousels programmatically. No other automation platform can do this — API-based tools simply don't have access to the sound library or the carousel creation flow.

carousel-with-sound.ts
// Create a TikTok carousel (photo mode) with a sound
const response = await fetch(
  'https://api.tokportal.com/v1/bundles/BUNDLE_ID/videos/1',
  {
    method: 'PUT',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      video_type: 'carousel',
      description: '5 skincare products that changed my skin ✨ #skincare',
      target_publish_date: '2026-03-15',
      // Carousel images (2-35 images supported)
      carousel_images: [
        'https://storage.example.com/product-1.jpg',
        'https://storage.example.com/product-2.jpg',
        'https://storage.example.com/product-3.jpg',
        'https://storage.example.com/product-4.jpg',
        'https://storage.example.com/product-5.jpg'
      ],
      // Sound is REQUIRED for TikTok carousels
      tiktok_sound_url: 'https://www.tiktok.com/music/chill-vibes-7234567890',
      volume_added_sound: 120
    })
  }
);

console.log('Carousel configured with sound');

Start posting with sounds

Full API reference for adding sounds, controlling volume, and creating carousels programmatically.

View API Docs
Can I use any TikTok sound, or only trending ones?+
You can use any sound available on TikTok — trending, older, or niche. Just provide the sound URL and TokPortal will apply it. However, using trending sounds gives you an algorithmic distribution boost, so they're recommended for maximum reach.
What happens if a sound gets removed from TikTok?+
If a sound is removed or made unavailable before your video is posted, the posting will fail and TokPortal will notify you. You'll need to select a different sound and reconfigure the video. This is rare but can happen with copyrighted music.
Does adding a sound cost extra?+
Adding a sound is free. The only additional cost is 1 credit per video if you set custom volume levels (volume_original_sound or volume_added_sound). If you use default volume (100/100), there's no extra charge.
Can I add sounds to Instagram Reels too?+
Yes, TokPortal supports adding sounds to Instagram Reels using the instagram_audio_name parameter. However, Instagram uses audio names rather than URLs, so the process is slightly different. Check the API documentation for Instagram-specific sound configuration.
Share
Vincent Tellenne

Written by

Vincent Tellenne

Founder & CEO

Vincent is the founder of TokPortal, building the infrastructure for scaled organic social media distribution. Previously scaled multiple startups and APIs to millions of requests.

Learn more about this topic with AI

Ready to launch?Start with TokPortal