---
title: "Create a report link the person can give their nutritionist or trainer"
method: POST
path: "/share-links"
tags: ["share"]
---

# Create a report link the person can give their nutritionist or trainer

`POST /share-links`

## Request

- Base URL: `https://nutri.coghorizon.com/api/v1`
- URL: `https://nutri.coghorizon.com/api/v1/share-links`
- 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: `share:manage`)

## Request body

- ShareLinkInput
  - `profile_id` string: One profile; every profile of the account when absent
  - `expires_in_days` integer: Link lifetime; no expiry when absent

## Response `201`

Link

- 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)