---
title: "Create Text Thread"
method: POST
path: "/texts/threads"
tags: ["Texts"]
---

# Create Text Thread

`POST /texts/threads`

## 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/texts/threads`
- Auth: none declared

Start (or reopen) the conversation with an outbound lead's phone number.

## Request body

- CreateTextThreadRequest
  - `outbound_lead_id` string, uuid, required

## Response `200`

Successful Response

- TextThreadListItem: One conversation in the Texts list.
  - `text_thread_id` string, uuid, required
  - `contact_phone` string, required
  - `business_phone` string, required
  - `contact_name` string, nullable: The linked outbound lead's name, else the thread's display name
  - `outbound_lead_id` string, uuid, nullable
  - `lead_id` string, uuid, nullable
  - `status` string, required
  - `last_message_at` string, date-time, nullable
  - `last_message_preview` string, nullable
  - `last_message_direction` string, nullable
  - `last_inbound_at` string, date-time, nullable
  - `is_unread` boolean, required
  - `needs_staff` boolean: The SMS agent handed this person to staff and no one at the firm has texted them or marked it handled since
  - `needs_staff_since` string, date-time, nullable: When the SMS agent handed the thread to staff, while it still needs them
  - `needs_staff_reason` string, nullable: Why the SMS agent handed the thread to staff, in the firm's words
  - `message_count` integer, required
  - `is_test` boolean, required
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-27** `4d3da2f87786`: 3 info
  - added the optional property `needs_staff` to the response with the `200` status
  - added the optional property `needs_staff_reason` to the response with the `200` status
  - added the optional property `needs_staff_since` to the response with the `200` status
- **2026-09-25** `2874401d2b40`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openintake/apis/openintake-api/changes/texts/threads/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)