Skip to main content
Requires an API key with full_access scope. Creates a webhook that will receive HTTP POST requests whenever the specified events occur in your workspace. The response includes a secret that you should store safely for verifying webhook signatures. The secret is only shown once.

Body

string
required
Webhook name. 2 to 100 characters.
string
required
The HTTPS endpoint that will receive webhook deliveries. Must start with https://.
string[]
required
List of event types to subscribe to. Must include at least one of:project.created, project.updated, project.deleted, job.created, job.updated, job.deleted, job_type.created, job_type.deleted

Response

string
The unique identifier of the newly created webhook.
string
Webhook name.
string
The delivery URL.
string[]
Subscribed event types.
string
Webhook status. Always active for new webhooks.
string
The webhook signing secret, prefixed with dbwhsec_. Use this to verify delivery signatures.
This is the only time the secret will be returned. Store it securely.
number
Unix timestamp (milliseconds) when the webhook was created.

Errors

400 Bad Request - Validation failed.
Other validation messages include:
  • name must be between 2 and 100 characters
  • url is required
  • url must start with https://
  • event_types is required and must include at least one of: project.created, ...
  • Invalid event type: {type}