Adding music to Instagram Reels through the API
Instagram's Audio API attaches music to a Reel when its container is created: GET /ig_audio finds original sounds or music authorized for third-party use, and audio_configuration on the REELS container sets the track and its volume. It runs with Facebook Login or Unified Login. With Instagram Login, the Reel's sound is the audio already in its video file.
easyCoexistence publishes Reels with publish_instagram_post from Claude, ChatGPT or your own code, now or from its scheduling queue, with the music you mixed into the video.
When Meta introduced the Instagram Audio API, for finding original sounds and Sound Collection music and attaching them to Reels.
Meta's Audio API runs with Facebook Login and Unified Login, and is not supported on the Instagram API with Instagram Login.
The range of audio_volume and video_volume in audio_configuration; both default to 100, full volume.
How many times a Reel's audio can be renamed with audio_name: at creation, or later from the audio page.
Songs and sounds in Meta's Sound Collection, royalty free and usable in Reels and for commercial purposes like ads.
The media_audio_type value for licensed music from Meta's catalog; ORIGINAL_SOUND marks original audio.
What does the Instagram API allow for a Reel's audio?
Five things, depending on the login. A Reel starts from the audio its video file carries, and the rest builds on that:
- The file's own audio: AAC, up to 48 kHz, mono or stereo, at 128 kbps, under Meta's Reels specification.
audio_name: a name for the Reel's audio, which can be set once.- The Audio API: search for original sounds and music, then attach one with
audio_configuration; Facebook Login and Unified Login only. media_audio_type: whether a published Reel uses MUSIC orORIGINAL_SOUND.- Copyright detection: matches found in a video's audio or picture, on Facebook Login and Unified Login.
How does audio_name work?
It names the audio of a Reel. audio_name goes on the REELS container with the video, and Meta's reference sets one rule for it: the audio can be renamed only once, either while the Reel is created or afterwards from its audio page in the app. Meta lists it for Reels only, without marking it for one login, and adds a Reels limitation nearby: music tagging is only available for original audio.
What is the Instagram Audio API?
Meta's way to put a track on a Reel from code, introduced on 1 June 2026. GET /ig_audio with audio_type set to music or original_sound and the account's user_id searches the catalog, a search_query narrows it, and with no query it returns trending audio. Each result carries an audio_id, a title and duration_in_ms, with display_artist for music. The calls need instagram_basic and instagram_content_publish, through Facebook Login or Unified Login.
How do you attach a track to a Reel?
On the REELS container, in the same call that sets video_url. audio_configuration is a JSON object holding the audio_id from the search, plus audio_volume for the track and video_volume for the video's own sound, each from 1 to 100 and 100 by default, so the two can be balanced against each other. The container is then published with media_publish, the same as any Reel.
POST https://<HOST_URL>/v26.0/<IG_ID>/media
media_type=REELS
video_url=https://cdn.example.com/reels/new-menu.mp4
audio_configuration={"audio_id":"<AUDIO_ID>","audio_volume":80,"video_volume":40}
access_token=<ACCESS_TOKEN>
POST https://<HOST_URL>/v26.0/<IG_ID>/media_publish
creation_id=<IG_CONTAINER_ID>
access_token=<ACCESS_TOKEN>Can the API add songs from Instagram's music library?
Only what Meta clears for apps. The Audio API returns audio authorized for third-party use, and Meta notes that its selection may differ from what the app offers. Instagram's Help Center adds that the licensed library is intended for personal, non-commercial use, that certain business accounts and certain types of posts have no access to it, and that licensed music may be unavailable in some countries or regions.
What happens to copyrighted music inside the video file?
Meta checks for it. With Facebook Login or Unified Login, copyright_check_status on a container says whether the check has run and found matches, and copyright_check_information on a published video lists the matched segments, marked AUDIO or VIDEO, with the owner's policy, such as BLOCK or MUTE in named countries. Meta also leaves media_url out of video with copyrighted or licensed audio, including audio from Instagram's own library, while other fields come back as normal.
How do you tell which audio a Reel uses?
Read media_audio_type on the published Reel. GET /<IG_MEDIA_ID>?fields=media_audio_type returns MUSIC, licensed music from Meta's catalog, or ORIGINAL_SOUND, original audio. Meta added the field on 1 June 2026 and returns it for video media such as Reels, not for photos or carousels, and its media reference does not tie it to one login.
What works with Instagram Login?
The audio in the file. A Reel published with Instagram Login sounds the way its video does, so music goes into the edit before upload, encoded as AAC at up to 48 kHz and 128 kbps, and only music the business has the right to use. Meta's Sound Collection is the catalog Instagram's Help Center describes as royalty free, safe to use in Reels and usable for commercial purposes like ads.
How does easyCoexistence publish a Reel with music?
With the music already in the video. publish_instagram_post takes the Reel's video_url and caption from Claude, ChatGPT or your own code, now or with scheduled_at, and Instagram publishes it with the file's own audio. easyCoexistence connects through Instagram Login, where Meta does not offer the Audio API. The tool takes no audio_name, so the audio is named in the Instagram app.
Common mistakes
- Calling GET /ig_audio from an Instagram Login app. Meta supports the Audio API on Facebook Login and Unified Login only.
- Keeping download_url as the track's file. It is a temporary preview link that expires after about 1.5 days, and it can be null.
- Expecting a preview before publishing. Meta does not support previewing a Reel with attached audio, which publishes as configured, so check the audio_id and volumes first.
US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
Can I add trending music to a Reel through the API?
With Facebook Login or Unified Login, yes: GET /ig_audio without a search_query returns trending audio, and its audio_id goes into audio_configuration. Instagram Login has no equivalent call.
Why can't my business account use some songs on Reels?
Instagram's Help Center says certain business accounts and certain types of posts have no access to the licensed music library, which is meant for personal, non-commercial use. Meta's Sound Collection is the royalty-free alternative.
Can a track from the Audio API be used in an ad?
Only when is_ads_eligible says so: Meta returns this nullable flag on each Audio API result to say whether the audio asset can be used in ads.
How much does easyCoexistence cost for publishing Instagram Reels?
Each Instagram account counts as one connection, at US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
Keep reading
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Verified on