---
title: "Create Parent"
method: POST
path: "/parents/"
tags: ["parents"]
---

# Create Parent

`POST /parents/`

## Request

- Base URL: `https://api.verdun.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.verdun.ai/parents/`
- Auth: HTTP bearer

## Request body

- CreateParentRequest
  - `company_name` string, required: Name of the client
  - `type` 'Monitoring Dealer' | 'End User' | 'Internal', required
  - `primary_contact_name` string, required: Name of the primary contact
  - `primary_contact_phone_number` string, required: Phone number of the primary contact
  - `primary_contact_email` string, required: Email of the primary contact
  - `notes` string, nullable: Notes about the client
  - `operator_ids` string[]: List of operator IDs to assign to this parent

## Response `200`

Successful Response

- CreateParentResponse
  - `id` string, uuid, required: Unique client id
  - `company_name` string, required: Name of the client
  - `type` 'Monitoring Dealer' | 'End User' | 'Internal', required
  - `primary_contact_name` string, required: Name of the primary contact
  - `primary_contact_phone_number` string, required: Phone number of the primary contact
  - `primary_contact_email` string, required: Email of the primary contact
  - `notes` string, nullable: Notes about the client
  - `disarm_number` string, nullable: The dealer's SMS line, which their customers text with a site passcode to turn cameras off. Null until one is bought.
  - `disarm_number_state` string, nullable: 'purchasing' means a purchase started and its outcome is unconfirmed -- re-POST to reconcile. 'attached' is display only: inbound texts route regardless of campaign attachment. 'releasing' means the line is being given back to Surge: new disarms are refused for this client until it clears, and a re-DELETE reconciles it.

## Other responses

- `422`: Validation Error

---

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