---
title: "Create webhook"
method: POST
path: "/webhooks"
tags: ["webhooks"]
---

# Create webhook

`POST /webhooks`

Creates a webhook that you can use to receive notifications about key events. Currently, webhooks are supported for the following events:

| **Event type** | **Description** |
| :--- | :--- |
| `project.created` | Fires when a new project is created |
| `project.updated` | Fires when a project is updated |
| `time.entry.created` | Fires when a new time entry is created |
| `time.entry.updated` | Fires when a time entry is updated |
| `user.created` | Fires when a new user is created |
| `user.updated` | Fires when a user is updated |
| `assignment.created` | Fires when a new assignment is created |
| `assignment.updated` | Fires when an assignment is updated |

## Request body

- WebhookCreateRequest
  - `url` string, uri, required — URL to which events should be posted. Must be an HTTPS URL with a valid host.
  - `event_type` 'project.created' | 'project.updated' | 'time.entry.created' | 'time.entry.updated' | 'user.created' | 'user.updated' | 'assignment.created' | 'assignment.updated', required — The type of event associated with the webhook.

## Response `200`

The webhook was created successfully.

- Webhook
  - `id` integer, required — Unique identifier for the webhook.
  - `url` string, uri, required — URL associated with the webhook, to which events are posted.
  - `status` 'active', required — The status of the webhook. Currently, the only valid status for a webhook is `active`.
  - `event_type` 'project.created' | 'project.updated' | 'time.entry.created' | 'time.entry.updated' | 'user.created' | 'user.updated' | 'assignment.created' | 'assignment.updated', required — The type of event associated with the webhook.
  - `organization_id` integer — Unique identifier for the organization.
  - `created_at` string, date-time — The time the webhook was created.
  - `updated_at` string, date-time — The time the webhook was last updated.

## Other responses

- `403` — The request body is invalid or a duplicate webhook already exists..

---

[API](https://skmtc.net/smartsheet/apis/resource-management-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/resource-management-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/resource-management-openapi-reference/versions/e4c439ac13f2/schema)