API Reference

Meta Ads / API Reference

meta_ads_create_instagram_post

Meta Ads tool. Create and publish a post on Instagram via the Facebook Page (Instagram Graph API). This is a 2-step process: first creates a container, then publishes it. For carousel posts, first create individual item containers, then pass their IDs in 'children'. Args: instagram_account_id: Instagram Business Account ID (required). image_url: Public URL of the image (JPEG/PNG) or video to post. For carousels, leave blank. caption: Post caption text. Optional. page_access_token: Page access token (required for posting). is_carousel: True to create a carousel post. Pass children IDs in 'children'. Default False. children: Comma-separated container IDs for carousel items. Only used when is_carousel=True.

This is a write tool: it creates instagram post in your Meta Ads account. Claude asks you to confirm before it runs.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

Create instagram post in my Meta Ads account for [instagram account id], [image url].

It takes 2 required and 4 optional parameters.

Parameters

ParameterTypeRequiredDescription
instagram_account_idstringYesInstagram Account Id
image_urlstringYesImage Url
captionstringNoCaption
page_access_tokenstringNoPage Access Token
is_carouselbooleanNoIs Carousel
childrenstringNoChildren

Related Meta Ads tools

Before you can call it

This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.

Workflows that use this

Rather than calling tools one at a time, these skills run a whole procedure against the same account:

Start using MCP Ads