API Reference

Webhooks overview

Webhooks are a way to connect and communicate between applications.

Object types

Webhook

Represents details of a webhook.

type Webhook {
	projectId: ID!
	webhookId: ID!
	event: WebhookEvent!
	url: URL!
	labels: [NonEmptyString]
	createdAt: DateTime!
	updatedAt: DateTime!
}

Webhook fields

Enums

WebhookEvent

enum WebhookEvent {
	BOOKING_CREATE
	BOOKING_UPDATE
}

WebhookEvent valid values

Queries

webhooks

Returns a list of webhooks.

webhooks(
	projectId: ID!
	limit: NonNegativeInt
	cursor: ID
): [Webhook]

webhooks arguments

<aside> 🔑 Minimal role required: ADMIN / APIADMIN

</aside>

webhook

Returns an Webhook resource by project & webhook ID.

webhook(
	projectId: ID!
	webhookId: ID!
): Webhook

webhook arguments

<aside> 🔑 Minimal role required: ADMIN / APIADMIN

</aside>

Mutations

webhookCreate

Creates a webhook.

webhookCreate(
	projectId: ID!
	event: WebhookEvent!
	url: URL!
	labels: [NonEmptyString]
): Webhook

webhookCreate arguments

<aside> 🔑 Minimal role required: ADMIN / APIADMIN

</aside>

webhookDelete

Removes a webhook.

webhookDelete(
	projectId: ID!
	webhookId: ID!
): String

webhookDelete arguments

<aside> 🔑 Minimal role required: ADMIN / APIADMIN

</aside>