---
title: "Create persons"
method: POST
path: "/v4/customers/{customerId}/persons"
tags: ["Persons"]
---

# Create persons

`POST /v4/customers/{customerId}/persons`

Creates one or more persons for the given customer. Insert-only; existing persons cannot be updated. Only available before compliance is completed.

## Path parameters

- `customerId` string, required

## Request body

- CreatePersonsV4RequestDto
  - `persons` CreatePersonV4RequestDto[], required
    - `firstName` string
    - `lastName` string
    - `address` AddressSharedDto
      - `line1` string, required — The first line of the address
      - `line2` string
      - `city` string, required
      - `country` string, required — ISO31661 Alpha2 code for the country
      - `state` string, required — 2-letter US state abbreviation
      - `postalCode` string, required — 5-digit US postal code
    - `dob` string — Date of birth in ISO 8601 format (YYYY-MM-DD)
    - `isApplicant` boolean
    - `isOwner` boolean
    - `isController` boolean
    - `title` string
    - `email` string
    - `phone` string — Phone number in E.164 format

## Response `200`

The created persons.

- PersonV4ResponseDto
  - `id` string, required
  - `customerId` string, required
  - `firstName` string
  - `lastName` string
  - `dob` string
  - `isApplicant` boolean, required
  - `isOwner` boolean, required
  - `isController` boolean, required
  - `title` string
  - `email` string
  - `phone` string
  - `address` AddressSharedDto
    - `line1` string, required — The first line of the address
    - `line2` string
    - `city` string, required
    - `country` string, required — ISO31661 Alpha2 code for the country
    - `state` string, required — 2-letter US state abbreviation
    - `postalCode` string, required — 5-digit US postal code

## Other responses

- `400` — Returned when improperly formatted or missing fields in request body
- `401` — Returned when improper keys or headers are used in the request
- `403` — Returned when the caller is not authorized to access the resource
- `404` — Returned when the customer is not found
- `500` — Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.net/slopepay/apis/slope-v4-api.md) · [All operations](https://skmtc.net/slopepay/apis/slope-v4-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slopepay/slope-v4-api/revisions/cbdbc861073b/schema)