> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hookmyapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inbox and sender profiles

> Read past conversations and look up who you are talking to.

## Conversation history

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

```bash theme={null}
# 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}"
```

Each conversation returns its participants and messages, newest first.<br />
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.

```bash theme={null}
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.<br />
Someone who only commented on a post returns a consent error until they send a DM.

## Next steps

* [Ice breakers and menus](/instagram/chat-setup): Set the questions and menu people see when a chat opens.
* [Receive webhooks](/instagram/receive-webhooks): Handle new messages as they arrive.