---
title: "Create a webhook"
method: POST
path: "/v1/workspaces/{workspaceId}/webhooks"
tags: ["Webhooks"]
---

# Create a webhook

`POST /v1/workspaces/{workspaceId}/webhooks`

Creating a webhook generates a new token which can be used to verify that the webhook being sent was sent by Clockify, as it will always be present in the header.

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.

## Request body

- CreateWebhookRequestV1
  - `name` string — Represents a webhook name.
  - `triggerSource` string[], required — Represents a list of trigger sources.
  - `triggerSourceType` 'PROJECT_ID' | 'USER_ID' | 'TAG_ID' | 'TASK_ID' | 'WORKSPACE_ID' | 'ASSIGNMENT_ID' | 'EXPENSE_ID', required — Represents a webhook event trigger source type.
  - `url` string, required — Represents a webhook target url.
  - `webhookEvent` 'NEW_PROJECT' | 'NEW_TASK' | 'NEW_CLIENT' | 'NEW_TIMER_STARTED' | 'TIMER_STOPPED' | 'TIME_ENTRY_UPDATED' | 'TIME_ENTRY_DELETED' | 'TIME_ENTRY_SPLIT' | 'NEW_TIME_ENTRY' | 'TIME_ENTRY_RESTORED' | 'NEW_TAG' | 'USER_DELETED_FROM_WORKSPACE' | 'USER_JOINED_WORKSPACE' | 'USER_DEACTIVATED_ON_WORKSPACE' | 'USER_ACTIVATED_ON_WORKSPACE' | 'USER_EMAIL_CHANGED' | 'USER_UPDATED' | 'NEW_INVOICE' | 'INVOICE_UPDATED' | 'NEW_APPROVAL_REQUEST' | 'APPROVAL_REQUEST_STATUS_UPDATED' | 'TIME_OFF_REQUESTED' | 'TIME_OFF_REQUEST_UPDATED' | 'TIME_OFF_REQUEST_APPROVED' | 'TIME_OFF_REQUEST_REJECTED' | 'TIME_OFF_REQUEST_STARTED' | 'TIME_OFF_REQUEST_WITHDRAWN' | 'BALANCE_UPDATED' | 'TAG_UPDATED' | 'TAG_DELETED' | 'TASK_UPDATED' | 'CLIENT_UPDATED' | 'TASK_DELETED' | 'CLIENT_DELETED' | 'EXPENSE_RESTORED' | 'ASSIGNMENT_CREATED' | 'ASSIGNMENT_DELETED' | 'ASSIGNMENT_PUBLISHED' | 'ASSIGNMENT_UPDATED' | 'EXPENSE_CREATED' | 'EXPENSE_DELETED' | 'EXPENSE_UPDATED' | 'PROJECT_UPDATED' | 'PROJECT_DELETED' | 'USER_GROUP_CREATED' | 'USER_GROUP_UPDATED' | 'USER_GROUP_DELETED' | 'USERS_INVITED_TO_WORKSPACE' | 'LIMITED_USERS_ADDED_TO_WORKSPACE' | 'COST_RATE_UPDATED' | 'BILLABLE_RATE_UPDATED', required — Represents a webhook event type.

## Response `201`

Created

- WebhookDtoV1 — unresolved $ref

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)