Play a custom soundboard sound in a Discord voice channel from a bot and manage guild soundboard sounds
domain: docs.discord.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Create a guild soundboard sound with POST /guilds/{guild.id}/soundboard-sounds, providing a base64 mp3 or ogg data URI plus name and optional emoji/volume
Confirm the source audio fits within the 512 KB file size and 5.2-second duration limits before uploading
Call POST /channels/{channel.id}/send-soundboard-sound with the sound_id (and source_guild_id if the sound belongs to a different server) to play it
Ensure the bot holds SPEAK and USE_SOUNDBOARD permissions, plus USE_EXTERNAL_SOUNDS if playing a sound sourced from another guild
Confirm the target user is connected to the voice channel with a voice state that has deaf, self_deaf, mute, and suppress all unset before attempting playback
Known gotchas
Sending a sound only fires a Voice Channel Effect Send Gateway event for users already connected to the voice channel — it will not connect a bot or user to voice on its own
A sound created in one guild can only be played in another guild's voice channel if the caller also has USE_EXTERNAL_SOUNDS and explicitly passes source_guild_id
A soundboard sound's available flag can flip to false purely from the guild losing Server Boosts, independent of anything the bot does — check available before attempting playback rather than assuming a previously-working sound_id still works
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?