Read someone who has messaged an Instagram account: their username and name,
and whether they follow the account. Use it to gate a comment-to-DM flow on a
follow: when the person taps your button, check isFollowing before sending
the link, and ask them to follow first if it is false.
The answer comes live from Instagram on every call, so a follow made a moment ago shows up straight away.
Path parameters
igsidstringRequired- The person's Instagram-scoped id:
from.idon amessage.createdevent orsenderIdon amessage.postback.
Query parameters
accountIduuidRequired- The connected Instagram account they messaged.
profileIduuid- Optional, because accountId names its profile. If you pass both, they must agree.
isFollowing is whether the person follows the account, and
isFollowedByAccount whether the account follows them. Either is null when
Instagram does not say.
Only after they message you
Instagram shares a person's profile only once they have sent the account a
message or tapped one of its buttons. Before that, the response is
409 user_consent_required. Someone who taps a button on your private reply
has already done so.
Errors — 401 unauthorized, 400 invalid_request, 404 profile_not_found,
404 account_not_found, 404 user_not_found, 409 user_consent_required,
403 permission_required with missing permission and reconnect details,
422 connection_expired, 502 provider_error.