---
title: "Create a note link"
method: POST
path: "/notes/{id}/links"
tags: ["Notes"]
---

# Create a note link

`POST /notes/{id}/links`

Creates a new note link. Links the note to a candidate, job, application, company, client contact, interview, or opportunity.

## Path parameters

- `id` string, required

## Request body

- CreateNoteLinkDto
  - `entityType` 'candidate' | 'vacancy' | 'client' | 'application' | 'clientContact' | 'interview' | 'opportunity', required
  - `entityId` string, required

## Response `201`

Note link created successfully.

- CreateRecordResponseDto
  - `id` string, required

## Other responses

- `400` — Bad request - missing or invalid required fields
- `401` — Unauthorized - invalid or missing authentication
- `404` — Note not found
- `409` — Conflict - the note is already linked to this entity
- `500` — Error response

---

[API](https://skmtc.net/spott/apis/spott-webhooks.md) · [All operations](https://skmtc.net/spott/apis/spott-webhooks/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spott/spott-webhooks/versions/ad1f8c51cf0a/schema)
