---
title: "Create Intake Link"
method: POST
path: "/intake-links"
tags: ["Intake Links"]
---

# Create Intake Link

`POST /intake-links`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/intake-links`
- Auth: none declared

A new link for a client. With a case number, the intake finishes that case and starts from what it has.

## Request body

- CreateIntakeLinkRequest
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `phone_number` string, nullable
  - `email` string, nullable
  - `case_number` string, nullable
  - `expires_in_days` integer

## Response `200`

Successful Response

- IntakeLinkResponse
  - `intake_link_id` string, uuid, required
  - `url` string, required
  - `status` string, required
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `phone_number` string, nullable
  - `email` string, nullable
  - `case_number` string, nullable
  - `source` string
  - `answered_count` integer
  - `incident_type` string, nullable
  - `incident_date` string, date, nullable
  - `language` string, nullable
  - `referral_id` string, uuid, nullable
  - `outcome` string, nullable
  - `sa_case_number` string, nullable
  - `was_dry_run` boolean
  - `needs_attention_reason` string, nullable
  - `expires_at` string, date-time, nullable
  - `opened_at` string, date-time, nullable
  - `last_activity_at` string, date-time, nullable
  - `submitted_at` string, date-time, nullable
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-26** `c3c270eb4e88`: 7 info
  - added the optional property `incident_date` to the response with the `200` status
  - added the optional property `incident_type` to the response with the `200` status
  - added the optional property `language` to the response with the `200` status
  - added the optional property `needs_attention_reason` to the response with the `200` status
  - …3 more
- **2026-10-26** `647752febae1`: 1 info
  - added the optional property `source` to the response with the `200` status
- **2026-10-26** `62d10ad76f8c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openintake/apis/openintake-api/changes/intake-links/post.md)

---

[API](https://skmtc.dev/openintake/apis/openintake-api.md) - [All operations](https://skmtc.dev/openintake/apis/openintake-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openintake/apis/openintake-api/revisions/de90a8dcbc07?raw)