v51

latestSwagger 2.0AGPL-3.0-or-laterraw.githubusercontent.com2026-08-0116998415.7 KB

webhooks

Create a webhook target

Create a webhook target which receives POST requests about specified events from a project.

put/projects/{id}/webhooks

Path parameters

idinteger required

Project ID

Request body

basic_auth_passwordstring

basic_auth_userstring

If provided, webhook requests will be sent with a Basic Auth header.

createdstring

A timestamp when this webhook target was created. You cannot change this value.

eventsstring[]

The webhook events which should fire this webhook target

idinteger

The generated ID of this webhook target

project_idinteger

The project ID of the project this webhook target belongs to

secretstring

If provided, webhook requests will be signed using HMAC. Check out the docs about how to use this: https://vikunja.io/docs/webhooks/#signing

target_urlstring

The target URL where the POST request with the webhook payload will be made

updatedstring

A timestamp when this webhook target was last updated. You cannot change this value.

user_idinteger

The user ID if this is a user-level webhook (mutually exclusive with ProjectID)

Response

The created webhook target.