Create Repo Web Hook

Creates a new webhook on the specified repository.

Example:

$ curl -X POST -u credentials -H 'Content-Type: application/json'
  https://api.bitbucket.org/2.0/repositories/my-workspace/my-repo-slug/hooks
  -d '
    {
      "description": "Webhook Description",
      "url": "https://example.com/",
      "active": true,
      "events": [
        "repo:push",
        "issue:created",
        "issue:updated"
      ]
    }'

Note that this call requires the webhook scope, as well as any scope that applies to the events that the webhook subscribes to. In the example above that means: webhook, repository and issue.

Also note that the url must properly resolve and cannot be an internal, non-routed address.

External Documentation

To learn more, visit the Bitbucket documentation.

Parameters

Parameter	Description
Active	-
Description	A user-defined description of the webhook.
Events	The events this webhook is subscribed to.
Repo Slug	This can either be the repository slug or the UUID of the repository, surrounded by curly-braces, for example: {repository UUID}.
URL	The URL events get delivered to.
Workspace Slug	This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example: {workspace UUID}.

Example Output

{
    "active": false,
    "created_at": "date-time",
    "description": "A user-defined description of the webhook.",
    "events": [
        "string"
    ],
    "subject": {
        "type": "string"
    },
    "subject_type": "The type of entity, which is `repository` in the case of webhook subscriptions on repositories.",
    "type": "string",
    "url": "The URL events get delivered to.",
    "uuid": "The webhook's id"
}

Workflow Library Example

Create Repo Web Hook with Bitbucket and Send Results Via Email

Preview this Workflow on desktop