---
title: "Create Person"
method: POST
path: "/v1/people"
tags: ["people"]
---

# Create Person

`POST /v1/people`

## Headers

- `X-API-Key` string, nullable

## Request body

- PersonCreate
  - `workspace_id` string, uuid, required
  - `name` string, nullable
  - `email` string, nullable
  - `phone` string, nullable
  - `job_title` string, nullable
  - `department` string, nullable
  - `seniority_label` string, nullable
  - `seniority_level` integer, nullable
  - `person_type` 'internal' | 'external'
  - `group_ids` string[]

## Response `201`

Successful Response

- PersonOut
  - `id` string, uuid, required
  - `workspace_id` string, uuid, required
  - `user_id` string, nullable
  - `source_connection_id` string, uuid, nullable
  - `external_id` string, nullable
  - `name` string, required
  - `email` string, nullable
  - `phone` string, nullable
  - `job_title` string, nullable
  - `department` string, nullable
  - `seniority_level` integer, nullable
  - `seniority_label` string, nullable
  - `person_type` string, required
  - `source` string, required
  - `source_attributes_json` object, nullable
  - `image_url` string, nullable
  - `group_ids` string[]
  - `group_names` string[]
  - `campaign_count` integer
  - `completed_count` integer
  - `last_participated_at` string, date-time, nullable
  - `channels` string[]
  - `teams_display_identifier` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ontora/apis/ontora-api.md) · [All operations](https://skmtc.dev/ontora/apis/ontora-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ontora/ontora-api/revisions/7f57037fd94b/schema)