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
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
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
patch
/organizations/{organizationId}/projects/{projectId}/settings/webhooks/{webhookId}

Last updated

Was this helpful?