List Instagram conversations

metaAds.listInstagramConversations lists an Instagram professional account’s direct-message conversations.

automations/meta-ads-list-instagram-conversations.automation.ts

import { automation, onDashboardRun } from "automate.ax"
import { metaAds } from "automate.ax/meta-ads"

export default automation("List Instagram conversations", () => {
  onDashboardRun({ title: "List Instagram conversations" })
  const conversations = metaAds.listInstagramConversations({
    instagramAccountId: "instagram-account-id",
    userId: "instagram-scoped-id",
  })
  // Pass a conversation ID to metaAds.listInstagramMessages.
})

Find instagramAccountId with List Instagram accounts. Pass userId, an IGSID, to find the conversation with one person. limit defaults to 25. Meta limits this edge to 2 calls per second per account and requires the Meta app to belong to a verified business. Optional second argument { account } selects a static project account binding. Returns conversations with id and updatedTime, plus a pageInfo cursor. The action needs instagram_basic, instagram_manage_messages, pages_manage_metadata, and pages_show_list.

Built-in triggers

Built-in actions

Runtime utilities

Integrations

List Instagram conversations