Create

  • POST
  • /workspaces
  • /:domain
  • /webhooks

Creates a new webhook. Restricted to admins only.

Request

REQUIRED SCOPES
WORKSPACE, WEBHOOK_ADD
url PARAMETERS
domainrequired string
The workspace domain.
POST PARAMETERS
eventsrequired string[]
The array of events describing when the webhook will be executed. Can be set of PUSH, EXECUTION_STARTED, EXECUTION_SUCCESSFUL, EXECUTION_FAILED or EXECUTION_FINISHED.
target_urlrequired string
The URL to which the payload will be sent.
projectsrequired string[]
The array of project name IDs from which webhooks will be executed.
secret_keyrequired string
The value sent in the payload required by the webservice to validate the request.

Last modified on Sep 23, 2024

{
  "target_url": "http://localhost",
  "secret_key": "mysecretkey",
  "projects": [
    "company-website",
    "beta-project"
  ],
  "events": [
    "EXECUTION_FAILED"
  ]
}
{
  "url": "https://api.buddy.works/workspaces/buddy/webhooks/2",
  "html_url": "https://app.buddy.works/buddy/webhook/2",
  "id": 2,
  "target_url": "http://localhost",
  "secret_key": "mysecretkey",
  "projects": [
    "company-website",
    "beta-project"
  ],
  "events": [
    "EXECUTION_FAILED"
  ]
}