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