Documentation menu
Messages

Get Instagram user

Read someone who messaged the account, and whether they follow it.

GEThttps://app.tryadeli.com/api/v1/messages/instagram/users/{igsid}
AuthorizationBearer <API key>How keys work

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.id on a message.created event or senderId on a message.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.