---
title: "CreatePersonRequest"
url: "https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8/schemas/CreatePersonRequest"
---

> Full API specification: https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8.md

# CreatePersonRequest

Fields for creating a new person. `firstName`, `lastName`, and `primaryEmail` are required. `sendInvite` defaults to `false`; set it to `true` to trigger an email invitation. Internal-only fields (customer ID, intake ID) are not accepted.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Identity API
  version: v1.275.8
servers:
  - url: https://api.sandbox.agentsync.io/id
    description: Sandbox server
  - url: https://api.agentsync.io/id
    description: Production server
components:
  schemas:
    PersonTitle:
      type: string
      nullable: true
      enum:
        - DR
        - MR
        - MRS
        - MS
        - MISS
      description: The person's honorific title.
      example: MS
    PersonSuffix:
      type: string
      nullable: true
      enum:
        - JR
        - SR
        - I
        - II
        - III
        - OBE
        - MBE
        - BSC
        - JP
        - GM
      description: The person's name suffix.
      example: JR
    PersonGender:
      type: string
      nullable: true
      enum:
        - MALE
        - FEMALE
      description: The person's gender.
      example: FEMALE
    CreatePersonRequest:
      title: CreatePersonRequest
      description: >
        Fields for creating a new person. `firstName`, `lastName`, and
        `primaryEmail` are required. `sendInvite` defaults to `false`; set it to
        `true` to trigger an email invitation. Internal-only fields (customer
        ID, intake ID) are not accepted.
      type: object
      required:
        - firstName
        - lastName
        - primaryEmail
      properties:
        firstName:
          type: string
          example: Jane
        lastName:
          type: string
          example: Smith
        middleName:
          type: string
          nullable: true
        preferredFirstName:
          type: string
          nullable: true
          maxLength: 100
        title:
          $ref: "#/components/schemas/PersonTitle"
        suffix:
          $ref: "#/components/schemas/PersonSuffix"
        dateOfBirth:
          type: string
          format: date
          nullable: true
        gender:
          $ref: "#/components/schemas/PersonGender"
        primaryEmail:
          type: string
          format: email
          example: jane.smith@example.com
        secondaryEmail:
          type: string
          format: email
          nullable: true
        citizenshipCountry:
          type: string
          nullable: true
        residentState:
          type: string
          nullable: true
        unitedStatesCitizen:
          type: boolean
          nullable: true
        unitedStatesWorkAuthorized:
          type: boolean
          nullable: true
        married:
          type: boolean
          nullable: true
        npn:
          type: string
          nullable: true
          maxLength: 12
          pattern: ^[1-9][0-9]*$
          description: National Producer Number. Must start with a non-zero digit and
            contain only digits.
        finraCrdNumber:
          type: string
          nullable: true
          maxLength: 11
          pattern: ^[0-9]+$
          description: FINRA CRD number. Must contain only digits.
        ssn:
          type: string
          nullable: true
          minLength: 9
          maxLength: 9
          pattern: ^[0-9]*$
          description: Social Security Number. Must be exactly 9 digits.
        sendInvite:
          type: boolean
          default: false
          description: When true, sends an email invitation to the person. Defaults to
            false.
```