Webhooks

post

Create webhook for an organization

🔒 Requires the create:webhook permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

namestringRequired

The name of the webhook. e.g. New Production Deployment

scopestring · enumOptional

The scope (org/env/dep/bp) at which the included events will trigger the webhook. e.g. environment

Possible values:

scope_idstringOptional

The ID of the selected scope. e.g. 25cd0bd6-d09b-4924-abfb-41768d111fe7

endpoint_urlstringRequired

User defined end-point for pushing webhook. e.g. https://bluebricks.co/webhooks/deployment

is_enabledbooleanOptional

If webhook is active. e.g. true

Responses

200

Created webhook

application/json

400

Failed to create webhook

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the create:webhook permission

application/json

429

Too many requests

application/json

post

/api/v1/webhook

POST /api/v1/webhook HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 128

{
  "name": "text",
  "scope": "organization",
  "scope_id": "text",
  "endpoint_url": "text",
  "is_enabled": true,
  "events": [
    "deployment:created"
  ]
}

{
  "id": "25cd0bd6-d09b-4924-abfb-41768d111fe7",
  "name": "New Production Deployment",
  "scope": "environment",
  "scope_id": "25cd0bd6-d09b-4924-abfb-41768d111fe7",
  "scope_slug": "production",
  "endpoint_url": "https://bluebricks.co/webhooks/deployment",
  "is_enabled": true,
  "created_by": "google-oauth2|1234567890",
  "created_at": "2026-01-10T03:46:10.280Z",
  "updated_at": null,
  "events": [
    "deployment:created",
    "deployment:updated"
  ]
}

get

Ability to get a webhook

🔒 Requires the read:webhook permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

webhookIdstring · uuidRequired

The webhook ID. e.g. 25cd0bd6-d09b-4924-abfb-41768d111fe7

Responses

200

Webhook information

application/json

400

Failed to retrieve webhook

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the read:webhook permission

application/json

404

Webhook not found

application/json

429

Too many requests

application/json

get

/api/v1/webhook/{webhookId}

GET /api/v1/webhook/{webhookId} HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "25cd0bd6-d09b-4924-abfb-41768d111fe7",
  "name": "New Production Deployment",
  "scope": "environment",
  "scope_id": "25cd0bd6-d09b-4924-abfb-41768d111fe7",
  "scope_slug": "production",
  "endpoint_url": "https://bluebricks.co/webhooks/deployment",
  "is_enabled": true,
  "created_by": "google-oauth2|1234567890",
  "created_at": "2026-01-10T03:46:10.280Z",
  "updated_at": null,
  "events": [
    "deployment:created",
    "deployment:updated"
  ]
}

put

Ability to update a webhook

🔒 Requires the update:webhook permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

webhookIdstring · uuidRequired

Body

namestringOptional

The name of the webhook. e.g. New Production Deployment

scopestring · enumOptional

The scope (org/env/dep/bp) at which the included events will trigger the webhook. e.g. environment

Possible values:

scope_idstringOptional

The ID of the selected scope. e.g. 25cd0bd6-d09b-4924-abfb-41768d111fe7

endpoint_urlstringOptional

User defined end-point for pushing webhook. e.g. https://bluebricks.co/webhooks/deployment

is_enabledbooleanOptional

If webhook is active. e.g. true

Responses

200

Updated webhook

application/json

400

Failed to update webhook

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the update:webhook permission

application/json

404

Webhook not found

application/json

429

Too many requests

application/json

put

/api/v1/webhook/{webhookId}

PUT /api/v1/webhook/{webhookId} HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 128

{
  "name": "text",
  "scope": "organization",
  "scope_id": "text",
  "endpoint_url": "text",
  "is_enabled": true,
  "events": [
    "deployment:created"
  ]
}

{
  "id": "25cd0bd6-d09b-4924-abfb-41768d111fe7",
  "name": "New Production Deployment",
  "scope": "environment",
  "scope_id": "25cd0bd6-d09b-4924-abfb-41768d111fe7",
  "scope_slug": "production",
  "endpoint_url": "https://bluebricks.co/webhooks/deployment",
  "is_enabled": true,
  "created_by": "google-oauth2|1234567890",
  "created_at": "2026-01-10T03:46:10.280Z",
  "updated_at": null,
  "events": [
    "deployment:created",
    "deployment:updated"
  ]
}

delete

Delete webhook by id

🔒 Requires the delete:webhook permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

webhookIdstring · uuidRequired

The webhook ID. e.g. 25cd0bd6-d09b-4924-abfb-41768d111fe7

Responses

200

Deletion success status

application/json

400

Failed to delete webhook

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the delete:webhook permission

application/json

404

Webhook not found

application/json

429

Too many requests

application/json

delete

/api/v1/webhook/{webhookId}

DELETE /api/v1/webhook/{webhookId} HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "25cd0bd6-d09b-4924-abfb-41768d111fe7"
}

get

List available webhooks for an organization

🔒 Requires the read:webhook permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

allbooleanOptional

Indicator to instruct the API if all or just active Webhooks. e.g. true

Default: true

filterstringOptional

Structure: [key1=value1,key2=value2&value3]

offsetnumberOptional

Results offset to allow pagination e.g. 10

Default: 0Example: 10

limitnumberOptional

Results limit to allow pagination, e.g. 50

Default: 20Example: 10

orderstringOptional

Specifies the order - ascending or descending - by which the returned list should be sorted e.g. ASC

sortstring · enumOptional

Specifies the attribute by which the returned list should be sorted. Can include the sort direction as ‘asc’ or ‘desc’. e.g. sort=name&order=asc

Default: created_atPossible values:

searchstringOptional

Enables searching within the list for webhook names that match a particular query. e.g. search=name

Responses

200

List of available webhooks

application/json

400

Failed to list available webhooks

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the read:webhook permission

application/json

429

Too many requests

application/json

get

/api/v1/webhooks

GET /api/v1/webhooks HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "total": 1,
  "stats": {
    "enable": 1
  },
  "list": [
    {
      "id": "25cd0bd6-d09b-4924-abfb-41768d111fe7",
      "name": "New Production Deployment",
      "scope": "environment",
      "scope_id": "25cd0bd6-d09b-4924-abfb-41768d111fe7",
      "scope_slug": "production",
      "endpoint_url": "https://bluebricks.co/webhooks/deployment",
      "is_enabled": true,
      "created_by": "google-oauth2|1234567890",
      "created_at": "2026-01-10T03:46:10.280Z",
      "updated_at": null,
      "events": [
        "deployment:created",
        "deployment:updated"
      ]
    }
  ],
  "filters": {
    "scopes": [
      "organization"
    ],
    "scope_ids": [
      "text"
    ],
    "endpoint_urls": [
      "text"
    ],
    "created_bys": [
      "text"
    ],
    "is_enabled": [
      "text"
    ],
    "events": [
      "text"
    ]
  }
}

PreviousUsers NextMCP

Last updated 1 month ago

Was this helpful?

Good night