---
title: "The link that hands a kept diary to its client (14 days; email optional: we send it there)"
method: POST
path: "/clients/{id}/invite"
tags: ["professionals"]
---

# The link that hands a kept diary to its client (14 days; email optional: we send it there)

`POST /clients/{id}/invite`

## Request

- Base URL: `https://nutri.coghorizon.com/api/v1`
- URL: `https://nutri.coghorizon.com/api/v1/clients/{id}/invite`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://nutri.coghorizon.com/oauth/authorize`, token URL `https://nutri.coghorizon.com/oauth/token`, scopes: `records:write`)

## Path parameters

- `id` string, required

## Request body

- InviteInput
  - `email` string, email: Only when the professional asks us to e-mail the link: the client's address. The client confirms their own address when accepting
  - `language` 'en' | 'es' | 'ru': Language of the invitation; the diary's language when absent

## Response `201`

Invitation

- object

## Other responses

- `400`: Validation failed
- `401`: Missing or invalid token
- `403`: Token lacks the scope
- `404`: Not found
- `429`: Rate limited

---

[API](https://skmtc.dev/coghorizon/apis/top-nutritionist-api.md) · [All operations](https://skmtc.dev/coghorizon/apis/top-nutritionist-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coghorizon/apis/top-nutritionist-api/revisions/928f04d72f8c?raw)