# Create borrower

Create a new borrower.

Endpoint: POST /people
Version: 2025-03-26
Security: oauth2, bearerAuth, apiKeyHeader

## Request fields (application/json):

  - `identity` (object)
    The borrower's identifier. For example, the Social Security number.

  - `identity.customIdentityTypeName` (string)
    The name of a personal or business ID. Required if `identityType=customID`. This needs to be "one word"
only US (a-zA-Z) letters. No numbers.
For example: Metrica Consular Card for Mexicans living abroad.
- `identityType=customID`
- `customIdentityTypeName=metricaConsularCard`

  - `identity.expirationDate` (string)
    Date the identification expires.

  - `identity.identityType` (string, required)
    Personal and business identifiers that are supported.
`customID` can be used for personal or business IDs that are not explicitly listed as one of the enum values.
If you pass `identityType=customID`, a `customIdentityTypeName` is also required.
For example: Metrica Consular Card for Mexicans living abroad.
- `identityType=customID`
- `customIdentityTypeName=metricaConsularCard`
    Enum: "SSN", "ITIN", "passport", "driversLicense", "taxID", "FEIN", "stateID", "customID"

  - `identity.issueDate` (string)
    Date the identification was issued.

  - `identity.issuingCountry` (string)
    Country that issued the identification. English short name according to ISO 3166-1 standard.

  - `identity.valid` (boolean)
    Whether the identity is valid.

  - `identity.value` (string, required)
    The value of a personal identifier. For example, *123456789*.

## Response 200 fields (application/json):

  - `message` (string)
    Description of the server action or error.

  - `status` (integer)
    HTTP status code.

  - `data` (any)

  - `data.identities` (array)

  - `data.identities.isPrimary` (boolean)
    Whether the identity is the borrower's primary identity or not. A borrower may
only have one primary identity. Primary identities can be created when
creating a borrower, or separately.

  - `data.redactedFields` (array)
    Paths of fields on this object whose values were hidden because your credentials lack the `person:read.pii` permission. Always present on responses that can carry personal data — an empty array means nothing was hidden. Paths are relative to this object. Objects nested inside this one, including every element of an array of objects, carry their own list rather than appearing here. A path ending in `[]` is an array of plain values such as `selfEmails[]`, and means at least one element of that array was hidden — not necessarily all of them. This field is never accepted on requests.
    Example: ["name.lastName","dateOfBirth"]