---
title: "POST /api/v1/persons"
method: POST
path: "/api/v1/persons"
tags: ["Persons"]
---

# POST /api/v1/persons

`POST /api/v1/persons`

## Request

- Base URL: `https://api.immy.bot` (the document declares no server; this is the origin it was published from)
- URL: `https://api.immy.bot/api/v1/persons`
- Auth: none declared

## Request body

- CreatePersonPayload
  - `tenantId` integer
  - `azurePrincipalId` string, nullable
  - `firstName` string, nullable
  - `lastName` string, nullable
  - `emailAddress` string, nullable
  - `onPremisesSecurityIdentifier` string, nullable

## Response `200`

OK

- GetSimplePersonResponse
  - `id` integer
  - `firstName` string, nullable
  - `lastName` string, nullable
  - `emailAddress` string, nullable, required
  - `azurePrincipalId` string, nullable
  - `tenantName` string, nullable
  - `tenantId` integer
  - `fullName` string, nullable
  - `updatedDateUTC` string, date-time
  - `createdDateUTC` string, date-time
  - `updatedBy` string, nullable
  - `personTagIds` integer[], nullable
  - `onPremisesSecurityIdentifier` string, nullable
  - `userId` integer, nullable
  - `userCreatedDateUTC` string, date-time, nullable
  - `userCreatedBy` string, nullable
  - `expirationDateUTC` string, date-time, nullable

---

[API](https://skmtc.dev/immy/apis/immy-bot-api.md) · [All operations](https://skmtc.dev/immy/apis/immy-bot-api/llms.txt) · [OpenAPI document](https://skmtc.dev/immy/apis/immy-bot-api/revisions/559d0e4b39d3?raw)