Webhook

Configure webhooks and delivery settings.

Get organizations project webhooks

get
/organizations/{organizationId}/projects/{projectId}/settings/webhooks

Get organizations project webhooks by organization user

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
organizationIdstringRequired

Entity ID

Pattern: ^[0-9a-fA-F]{24}$
projectIdstringRequired

Entity ID

Pattern: ^[0-9a-fA-F]{24}$
Responses
chevron-right
200

OK

application/json

Project webhook

_idstringRead-onlyOptional

Entity ID

Example: 63ea10b94a472e003305232bPattern: ^[0-9a-fA-F]{24}$
namestringOptional

Webhook name

urlstring · uriOptional

Webhook URL

headersobjectOptional

Webhook headers

activebooleanOptional

Webhook is active

Default: true
createdAtstring · date-timeRead-onlyOptional

Date

updatedAtstring · date-timeRead-onlyOptional

Date

get
/organizations/{organizationId}/projects/{projectId}/settings/webhooks

Create a organization project webhook

post
/organizations/{organizationId}/projects/{projectId}/settings/webhooks

Create a organization project webhook by organization user

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
organizationIdstringRequired

Entity ID

Pattern: ^[0-9a-fA-F]{24}$
projectIdstringRequired

Entity ID

Pattern: ^[0-9a-fA-F]{24}$
Body
namestringRequired

Webhook name

Example: <name>
urlstringRequired

Webhook URL

Example: <url>
headersobjectOptional

Webhook headers

activebooleanOptional

Webhook active status

Default: trueExample: <active>
eventsstring[]Required

Webhook events

Example: ["deployment.build.created"]
Responses
post
/organizations/{organizationId}/projects/{projectId}/settings/webhooks

Get organizations a project webhook

get
/organizations/{organizationId}/projects/{projectId}/settings/webhooks/{webhookId}

Get a organization project webhook by organization user

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
organizationIdstringRequired

Entity ID

Pattern: ^[0-9a-fA-F]{24}$
projectIdstringRequired

Entity ID

Pattern: ^[0-9a-fA-F]{24}$
webhookIdstringRequired

Entity ID

Pattern: ^[0-9a-fA-F]{24}$
Responses
chevron-right
200

OK

application/json

Project webhook

_idstringRead-onlyOptional

Entity ID

Example: 63ea10b94a472e003305232bPattern: ^[0-9a-fA-F]{24}$
namestringOptional

Webhook name

urlstring · uriOptional

Webhook URL

headersobjectOptional

Webhook headers

activebooleanOptional

Webhook is active

Default: true
createdAtstring · date-timeRead-onlyOptional

Date

updatedAtstring · date-timeRead-onlyOptional

Date

get
/organizations/{organizationId}/projects/{projectId}/settings/webhooks/{webhookId}

Delete a project webhook

delete
/organizations/{organizationId}/projects/{projectId}/settings/webhooks/{webhookId}

Delete a project webhook by organization user

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
organizationIdstringRequired

Entity ID

Pattern: ^[0-9a-fA-F]{24}$
projectIdstringRequired

Entity ID

Pattern: ^[0-9a-fA-F]{24}$
webhookIdstringRequired

Entity ID

Pattern: ^[0-9a-fA-F]{24}$
Responses
delete
/organizations/{organizationId}/projects/{projectId}/settings/webhooks/{webhookId}

No content

Update a project webhook

patch
/organizations/{organizationId}/projects/{projectId}/settings/webhooks/{webhookId}

Update a project webhook by organization user

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
organizationIdstringRequired

Entity ID

Pattern: ^[0-9a-fA-F]{24}$
projectIdstringRequired

Entity ID

Pattern: ^[0-9a-fA-F]{24}$
webhookIdstringRequired

Entity ID

Pattern: ^[0-9a-fA-F]{24}$
Body
namestringOptional

Webhook name

Example: <name>
urlstringOptional

Webhook URL

Example: <url>
headersobjectOptional

Webhook headers

activebooleanOptional

Webhook active status

Default: trueExample: <active>
eventsstring[]Optional

Webhook events

Example: ["deployment.build.created"]
Responses
chevron-right
200

OK

application/json
and
patch
/organizations/{organizationId}/projects/{projectId}/settings/webhooks/{webhookId}

Last updated

Was this helpful?