Bitbucket Hook Integration Events

[deku2aofa]

Hi,

I am trying to create an integration with your platform to handle events published by Bitbucket for the different variations you support (e.g., pull requests (created, updated, ...), Repository events, etc) - as documented in webhooks. However, after going through the given documentation, I failed to encounter documentation on the User entity needed, for instance, for the Build Status Updated payload. It's mentioned it's supposed to be in the Common Entities area, but it's not.

Can you please provide its specification? Also, could this documentation be improved with samples of implementation of a given hook with at least one programming language? It would probably help fill some gaps for people when trying to understand this and have a certified guide on how to do it properly? 

Best Regards,

[DPKJ]

@deku2aofaWelcome to the Atlassian Community.

Yes you are correct about the state of documentation here, this need immediate attention. After GDPR related changes made by Atlassian they removed User Object section but haven't removed references to this in documentation, which is pretty bad situation for someone who want to develop on this. I will make Atlassian take a look at this, and update documentation as soon as possible.

Now coming to your query, how does payload looks like for user? one major difference from earlier is it doesn't contain email address now, and fields depend upon visible settings of user. Here is a sample I received one payload today morning,

"owner": {
  "display_name": "<DISPLAY_NAME_FULL_NAME>",
  "uuid": "{<USER_UUID>}",
  "links": {
    "self": {
      "href": "https://api.bitbucket.org/2.0/users/<USER_UUID>"
    },
    "html": {
      "href": "https://bitbucket.org/USER_UUID/"
    },
    "avatar": {
      "href": "https://avatar-management--avatars.us-west-2.prod.public.atl-paas.net/<UUID_PATH_TO_AVATAR>"
    }
  },
  "nickname": "<NICK_NAME>",
  "type": "user",
  "account_id": "<ACCOUNT_ID>"
}

Moreover, for ease of development you create a free public https://requestbin.com bin and add RequestBin provided url in webhooks section to take a look at all the webhooks. Use this images for reference,