---
title: "Create Watcher Link"
method: POST
path: "/api/v4/mining/watcher-links/create"
tags: ["Mining Pool"]
---

# Create Watcher Link

`POST /api/v4/mining/watcher-links/create`

Creates a new watcher link for one or more mining accounts, granting specific permissions with a configurable expiration.

<Note>
The number of active watcher links per mining account is capped (configurable
server-side; currently 3 by default). Exceeding the cap returns a `400` with
`Limit exceeded`.
</Note>

<Warning>
Rate limit: 1000 requests/10 sec.
</Warning>

## Request body

- object
  - `accounts` string[], required — Array of mining account names
  - `name` string, required — Link name (alphanumeric and underscores only)
  - `permissions` string[], required — Array of permissions
  - `liveUntil` '1h' | '24h' | '7d' | 'always', required — Expiration period

## Response `201`

Watcher link created successfully

- object
  - `data` object
    - `id` string
    - `link` string
    - `liveUntil` integer, nullable
    - `createdAt` integer

## Other responses

- `400` — Validation failed

---

[API](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4.md) · [All operations](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whitebit/whitebit-private-http-api-v4/versions/76c9def9942f/schema)