---
title: "Subscribe a new hook"
method: POST
path: "/hooks/subscribe"
tags: ["Hooks"]
---

# Subscribe a new hook

`POST /hooks/subscribe`

Subscribe a new hook. The hook will be ready immediately after the response

## Request body

- CreateHook
  - `url` string, required
  - `event` 'timeEntry.created' | 'timeEntry.updated' | 'timeEntry.deleted', required

## Response `201`

Hook created

- object
  - `id` string

## Other responses

- `401` — Error: Unauthorized
- `403` — Forbidden access or subscription and trial phase ended.
- `422` — Validation failed

---

[API](https://skmtc.net/timelink/apis/timelink-api.md) · [All operations](https://skmtc.net/timelink/apis/timelink-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timelink/timelink-api/revisions/113f9953e62a/schema)