Messenger Platform
Messenger Platform
Resources

messaging_account_linking Webhook Event Reference

Updated: Nov 16, 2017
When using Account Linking, this callback will occur when the Link Account or Unlink Account button have been tapped.
The status parameter tells you whether the user linked or unlinked their account. The authorization_code is a pass-through parameter. allowing you to match the business user entity to the page-scoped ID (PSID) of the sender.

Example

{
  "sender":{
    "id":"USER_ID"
  },
  "recipient":{
    "id":"PAGE_ID"
  },
  "timestamp":1234567890,
  "account_linking":{
    "status":"linked",
    "authorization_code":"PASS_THROUGH_AUTHORIZATION_CODE"
  }
}
{
  "sender":{
    "id":"USER_ID"
  },
  "recipient":{
    "id":"PAGE_ID"
  },
  "timestamp":1234567890,
  "account_linking":{
    "status":"unlinked"
  }
}

Properties

sender

sender Field Description
id string
The Page-scoped ID for the person who sent a message to your business

recipient

recipient Field Description
id string
The ID for your Facebook Page

account_linking

Property Description Type
status
linked or unlinked
String
authorization_code
Value of pass-through authorization_code provided in the Account Linking flow
String
Note: authorization_code is only available when status is linked
Did you find this page helpful?
Thumbs up icon
Thumbs down icon