Log inStart Free Trial
easyCoexistence Official APIs

Instagram user IDs: IG_ID, IGSID and app-scoped IDs

Instagram's API uses three kinds of user ID. The IG_ID is a professional account's ID: GET /me returns it as user_id with Instagram Login, webhooks carry it as entry.id, and paths such as /<IG_ID>/media take it. An IGSID, or Instagram-scoped ID, stands for a person who messages or comments on that account. The app-scoped ID is the id field /me returns.

easyCoexistence gives each connected Instagram account one account_id for its tools, alongside the IG_ID, and forwards Meta's events with the IGSIDs they carry, so Claude, ChatGPT or your own code can reply to comments and DMs through Meta's official API.

user_id

The /me field holding the Instagram professional account ID, which is the id in that account's webhook notifications.

id

On /me with Instagram Login, the app user's app-scoped ID.

Per account

An IGSID is specific to the person and the Instagram account they interact with.

sender.id

Where a received DM's webhook carries the person's IGSID; recipient.id holds the account's ID.

Consent

Needed for the User Profile API; Meta sets it when the person messages the account or taps an ice breaker or menu.

What is an IG_ID?

The ID of an Instagram professional account, the object most calls are made on. With Instagram Login, GET /me?fields=user_id,username returns it as user_id, and Meta's guide says it equals the id in the account's webhook notifications, entry.id. With Facebook Login, a Page returns it in its instagram_business_account field. Paths such as /<IG_ID>/media, /<IG_ID>/conversations and /<IG_ID>/insights take it.

What is an IGSID?

An Instagram-scoped ID, created when someone comments on the account's post, Reel or Story, or sends it a message. Meta scopes it to the person and the account they interact with, so the same person has a different IGSID with each professional account, while it stays the same across apps: Meta says it lets a business map one person's interactions across multiple apps. It is the ID to reply to, find a conversation with and look a person up by.

What is the app-scoped ID?

The id field of GET /me under Instagram Login, which Meta's guide describes as the app user's app-scoped ID; its sample calls use user_id, not id, in the paths that follow. The code exchange at login also returns a user_id, which the login guide calls the app user's Instagram-scoped user ID. Since the get-started guide ties /me's user_id to webhook notifications, that is the value to store as the IG_ID.

Where does each ID appear?

Meta's references and webhook examples place them as below. A person shows up as an IGSID whether they comment or write a DM, and the account as its IG_ID: the recipient on DMs it receives, the sender on DMs it sends:

GET /me user_idIG_ID, the professional account
GET /me idApp-scoped ID of the app user
Webhook entry.idIG_ID of the account the event belongs to
comments value.from.idIGSID of the person who commented
messages sender.idIGSID on a received DM; the IG_ID on one the account sent
Conversations user_idIGSID that finds that person's conversation
Message from and toAn id with a username for each side
Page instagram_business_accountIG_ID, with Facebook Login

How do you look up a person from an IGSID?

With the User Profile API: GET /<IGSID> on graph.instagram.com, with instagram_business_basic and instagram_business_manage_messages. It needs the person's consent, which Meta sets only when they message the account or tap an ice breaker or persistent menu item. profile_pic URLs expire in a few days, and a person who has blocked the account cannot be looked up.

A person's profile from their IGSID
GET https://graph.instagram.com/<IGSID>
  ?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user
  &access_token=<ACCESS_TOKEN>

Can one kind of ID be turned into another?

The routes Meta documents are lookups. From an IGSID, the User Profile API gives the person's username. From a username, Business Discovery returns another business or creator account's id, with Facebook Login or Unified Login. From a token, GET /me gives the IG_ID. An IGSID belongs to one professional account, so the same person's IGSID seen by another account differs from it.

Which IDs does easyCoexistence use?

Meta's, plus one of its own. list_social_accounts returns account_id, easyCoexistence's ID for the connection that the other tools take, and external_id, the IG_ID; get_social_credentials returns the IG_ID as account_id_on_meta. Forwarded events arrive as platform, account_id, external_id and Meta's entry unchanged, and send_social_dm takes the person's IGSID as recipient_id.

Common mistakes

  • Storing the user_id from the code exchange as the account's ID. Read user_id from GET /me, which Meta ties to the id in webhook notifications.
  • Reusing an IGSID across professional accounts. It is scoped to one account, so the same person has another IGSID elsewhere.
  • Looking up a commenter who never wrote. Meta sets consent only when the person messages the account or taps an ice breaker or menu item.
  • Saving profile_pic URLs. Meta says they expire in a few days, so request them again when needed.
Doing this with EasyCoexistence

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Is the IGSID the same as the Instagram user ID?

No. An IGSID identifies a person to one professional account, while the IG_ID identifies a professional account itself.

Why doesn't my webhook ID match the ID from login?

The code exchange returns a user_id that Meta calls Instagram-scoped, while webhook notifications carry the user_id GET /me returns. Store the one from /me.

Can I get someone's Instagram username from an IGSID?

Yes, through the User Profile API, once the person has messaged the account or tapped an ice breaker or persistent menu item.

Does the IGSID change between apps?

No. Meta says it lets businesses map the same person's interactions across multiple apps, though it differs from one professional account to another.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on