Instagram, Facebook and Threads

Beyond publishing, comments and direct messages, Postgale covers the rest of what Meta's APIs offer for Instagram (Instagram API with Instagram Login), Facebook Pages and Threads. Paths and field names follow Zernio's, so a client written for Zernio works by changing the base URL to https://postgale.com/api/v1. On the MCP server the same operations are meta_account_settings, instagram_lookup, facebook_page_data, list_reviews, reply_to_review and meta_conversation_action, plus the cross-platform tools moderate_comment (private replies), send_message (quickReplies, buttons), send_typing, delete_conversation, like_post, pin_post, list_platform_posts and reply_to_mention.

Every change that reaches Instagram or Facebook (settings, Page info, review replies, private replies, reactions, handover, likes) is queued for human approval while approval applies to the key, the organization or the account: the answer is 202 {id, status: "pending_approval"} and nothing reaches Meta until a person approves it. Reads are never queued. Typing indicators are not queued: they publish nothing.

DM settingsCopy Anchor Link

What people see when they open a conversation with the account. Each setting has GET, PUT (replaces every locale) and DELETE.

curl -X PUT https://postgale.com/api/v1/accounts/acc_ig/instagram-ice-breakers \
  -H 'Authorization: Bearer sk_…' \
  -H 'Content-Type: application/json' \
  -d '{"ice_breakers":[{"question":"Do you ship to Canada?","payload":"SHIPPING"},{"question":"Where is my order?","payload":"ORDER_STATUS"}]}'

A tap sends the payload as a postback, which arrives as message.received. Facebook shows a persistent menu only on a Page with a Get Started button, and refuses deleting Get Started while a menu is set.

Facebook Page infoCopy Anchor Link

GET /accounts/{id}/facebook-page-info returns about, description, website, phone, emails and hours ({day}_{1|2}_{open|close}, e.g. mon_1_open: "09:00"). PATCH sends only the fields in the body ("" clears a text field) and returns the info read back from Meta.

Interactive DMs and private repliesCopy Anchor Link

POST /inbox/conversations/{id}/messages with text plus quickReplies (up to 13 chips) or buttons (1 to 3, postback with payload or url), inside the 24-hour window:

curl -X POST https://postgale.com/api/v1/inbox/conversations/conv_123/messages \
  -H 'Authorization: Bearer sk_…' \
  -H 'Content-Type: application/json' \
  -d '{"text":"Which size?","quickReplies":[{"title":"S"},{"title":"M"},{"title":"L"}]}'

A private reply DMs the author of a comment: one per comment, within 7 days of it. The conversation with the commenter is stored and message.sent fires.

curl -X POST https://postgale.com/api/v1/inbox/comments/17895695668004550/17858893269000001/private-reply \
  -H 'Authorization: Bearer sk_…' \
  -H 'Content-Type: application/json' \
  -d '{"accountId":"acc_ig","message":"Sent you the link!"}'

The first segment is the post (media) id and the second the comment id, as in Zernio (/inbox/comments/{commentId}/private-reply also works).

Conversation actionsCopy Anchor Link

Facebook reviewsCopy Anchor Link

GET /inbox/reviews lists the reviews (recommendations) of every connected Page, or of one with accountId, with minRating, maxRating, hasReply, sortBy (date, rating) and sortOrder. POST /inbox/reviews/{reviewId}/reply publishes the Page's reply. Deleting a reply is a Google Business Profile feature and answers 400 on Facebook.

Facebook analyticsCopy Anchor Link

A metric Meta does not return is listed in unavailableMetrics instead of being reported as 0.

Instagram readsCopy Anchor Link

Mentioned media and comments (/instagram/mentions/media/{mediaId}, /instagram/mentions/comments/{commentId}), business discovery (/instagram/business-discovery?username), the audio catalog (/instagram/audio, /instagram/audio/{audioId}), live media (/instagram/live-media), media collaborators (/instagram/media/{mediaId}/collaborators) and likes are served by Meta only to Instagram accounts connected through Facebook Login. Postgale connects Instagram with Instagram Login, so these answer 400 with a code such as instagram_business_discovery_requires_facebook_login (in mock mode they return sample data).

Posts and mentionsCopy Anchor Link

• GET /accounts/{id}/posts: the account's latest posts as they are on Instagram, Facebook or Threads (also used by POST /posts/sync-external).
• POST / DELETE /inbox/posts/{postId}/like with {accountId}: like or unlike a post as a Facebook Page. Instagram needs Facebook Login and Threads has no like API: both answer 400.
• POST /posts/{id}/pin and /unpin: pin a published post to the top of the Facebook Page.
• POST /inbox/mentions/reply {accountId, mediaId, commentId?, message}: reply where the Instagram account was @mentioned.

ThreadsCopy Anchor Link

Replies can be listed, answered, hidden and deleted (DELETE /inbox/comments/{commentId}?accountId, which needs threads_delete). New replies to the account's threads arrive as comment.received.

WebhooksCopy Anchor Link

Besides message.received, message.sent, message.read, message.delivered and message.reaction:

• reaction.received: the person added or removed a reaction (sent alongside message.reaction).
• message.edited: the person edited a message; text is the new text and previousText the old one (Instagram and Messenger).
• message.deleted: the person unsent a message on Instagram; text and attachments carry the original content.

Edits need the message_edit (Instagram) and message_edits (Facebook) webhook fields on the account's subscription (POST /accounts/{id}/webhook-subscription).