Inbox and sender profiles - HookMyApp

Conversation history

Webhooks deliver messages as they arrive. The conversations list gives you everything that came before.

# List conversations
curl "https://gateway.hookmyapp.com/meta/v25.0/me/conversations?platform=instagram" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"

# List conversations with the messages in each thread
curl --globoff "https://gateway.hookmyapp.com/meta/v25.0/me/conversations?platform=instagram&fields=participants,messages{id,created_time,from,message}" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"

# One thread. A conversation has no /messages edge, so expand the field on the node
curl --globoff "https://gateway.hookmyapp.com/meta/v25.0/${CONVERSATION_ID}?fields=messages{id,created_time,from,message}" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"
# Messages come back nested under messages.data

Each conversation returns its participants and messages, newest first.
Both lists are paginated: follow the top-level paging.next URL for more conversations, and each conversation’s messages.paging cursors for older messages.

Who you are talking to

Look up the profile behind an IGSID from a webhook, so replies can use their name or adapt to whether they follow you.

curl "https://gateway.hookmyapp.com/meta/v25.0/${IGSID}?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user" \
  -H "Authorization: Bearer ${INSTAGRAM_ACCESS_TOKEN}"

Field	What you get
`name`, `username`	Display name and handle. `name` can be null
`profile_pic`	Profile picture URL. Expires after a few days
`follower_count`	Their follower count
`is_user_follow_business`	Whether they follow you
`is_business_follow_user`	Whether you follow them

The profile is only available after the person messages you, or taps an ice breaker or menu item.
Someone who only commented on a post returns a consent error until they send a DM.

Next steps

Ice breakers and menus: Set the questions and menu people see when a chat opens.
Receive webhooks: Handle new messages as they arrive.

Read the inbox with the CLI

# Threads, most recently updated first
hookmyapp instagram threads --channel @your-handle

# The messages in one thread
hookmyapp instagram threads --channel @your-handle --thread <thread-id>

# Who is on the other end
hookmyapp instagram threads --channel @your-handle --participant <igsid>

Read the inbox with MCP

list_instagram_conversations covers all three: the thread list, one thread’s messages, and the profile behind an IGSID. Read the thread before send_message so a reply is written with the history in view.

Use HookMyApp MCP to catch me up on the Instagram DMs that came in overnight and draft replies to the ones asking about delivery.