---
title: "Creates a property-owner persona on an application"
method: POST
path: "/posfinancing/rest/v2/applications/{applicationId}/personas"
tags: ["Application"]
---

# Creates a property-owner persona on an application

`POST /posfinancing/rest/v2/applications/{applicationId}/personas`

## Request

- Base URL: `https://devint01-api.goodleap.com`
- URL: `https://devint01-api.goodleap.com/posfinancing/rest/v2/applications/{applicationId}/personas`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/goodleap/apis/developer-api/docs/posfinancing/rest/v2/applications/:applicationId/personas/post.ts> (a function with typed inputs; its response is checked against the schema)

Personas

## Path parameters

- `applicationId` unknown, required

## Request body

- UndefinedCreateApplicationPersonaInput
  - `nameOnTitle` UndefinedNameOnTitleInput
    - `first` string, required: The first name as it appears on the title.
    - `last` string, required: The last name as it appears on the title.
  - `primaryPhoneNumber` UndefinedPhoneInputDto, required
    - `phoneNumber` string, required: The phone number.
    - `type` 'HOME' | 'MOBILE', required: The phone number type.
  - `secondaryPhoneNumber` UndefinedPhoneInputDto
    - `phoneNumber` string, required: The phone number.
    - `type` 'HOME' | 'MOBILE', required: The phone number type.
  - `maritalPartner` UndefinedApplicationPersonaMaritalPartnerInput
    - `firstName` string, required: The marital partner's first name.
    - `lastName` string, required: The marital partner's last name.
    - `email` string, required: The marital partner's email address.
    - `primaryPhoneNumber` UndefinedPhoneInputDto, required
      - `phoneNumber` string, required: The phone number.
      - `type` 'HOME' | 'MOBILE', required: The phone number type.
    - `secondaryPhoneNumber` UndefinedPhoneInputDto
      - `phoneNumber` string, required: The phone number.
      - `type` 'HOME' | 'MOBILE', required: The phone number type.
    - `homeOccupancy` 'PRIMARY' | 'SECONDARY' | 'INVESTMENT' | 'OTHER': Occupancy status of the marital partner's property. Required when the subject property is in a homestead state.
  - `firstName` string, required: The persona's first name.
  - `lastName` string, required: The persona's last name.
  - `email` string, required: The persona's email address.
  - `maritalStatus` 'SINGLE' | 'MARRIED' | 'DIVORCED' | 'SEPARATED' | 'WIDOWED', required: The persona's marital status.
  - `homeOccupancy` 'PRIMARY' | 'SECONDARY' | 'INVESTMENT' | 'OTHER': Occupancy status of the persona's property. Required when the subject property is in a homestead state.

## Response `201`

Resource created successfully.

- SchemaObject11
  - `payload` object, required: The response data.
    - `id` string, required: The unique identifier of the persona.
    - `type` 'PROPERTY_OWNER', required: The persona type.
    - `firstName` string, required: The persona's first name.
    - `lastName` string, required: The persona's last name.
    - `email` string: The persona's email address.
    - `primaryPhoneNumber` UndefinedPhone
      - `countryCode` string, required: The country code in E.164 format.
      - `isoCountryCode` string: The country in ISO 3166-1 alpha-2 format. Defaults to US.
      - `phoneNumber` string, required: The phone number.
      - `type` 'HOME' | 'MOBILE', required: The phone number type.
    - `secondaryPhoneNumber` UndefinedPhone
      - `countryCode` string, required: The country code in E.164 format.
      - `isoCountryCode` string: The country in ISO 3166-1 alpha-2 format. Defaults to US.
      - `phoneNumber` string, required: The phone number.
      - `type` 'HOME' | 'MOBILE', required: The phone number type.
    - `maritalStatus` 'SINGLE' | 'MARRIED' | 'DIVORCED' | 'SEPARATED' | 'WIDOWED': The persona's marital status.
    - `maritalPartner` UndefinedPersonaMaritalPartnerDto
      - `firstName` string, required: The marital partner's first name.
      - `lastName` string, required: The marital partner's last name.
      - `email` string, required: The marital partner's email address.
      - `primaryPhoneNumber` UndefinedPhone, required
        - `countryCode` string, required: The country code in E.164 format.
        - `isoCountryCode` string: The country in ISO 3166-1 alpha-2 format. Defaults to US.
        - `phoneNumber` string, required: The phone number.
        - `type` 'HOME' | 'MOBILE', required: The phone number type.
      - `secondaryPhoneNumber` UndefinedPhone
        - `countryCode` string, required: The country code in E.164 format.
        - `isoCountryCode` string: The country in ISO 3166-1 alpha-2 format. Defaults to US.
        - `phoneNumber` string, required: The phone number.
        - `type` 'HOME' | 'MOBILE', required: The phone number type.
      - `homeOccupancy` 'PRIMARY' | 'SECONDARY' | 'INVESTMENT' | 'OTHER': Occupancy status of the marital partner's property. Required when the subject property is in a homestead state.
    - `nameOnTitle` UndefinedNameOnTitleDto
      - `first` string, required: The first name as it appears on the title.
      - `last` string, required: The last name as it appears on the title.
    - `homeOccupancy` 'PRIMARY' | 'SECONDARY' | 'INVESTMENT' | 'OTHER': Occupancy status of the persona's property.
    - `createdAt` string, date-time, required: The timestamp of when the persona was created.

## Other responses

- `400`: The request cannot be processed due to malformed data.
- `401`: Unauthorized access to the requested resource.
- `403`: Access to the requested resource is forbidden.
- `404`: The resource was not found.
- `409`: The request cannot be processed due to a conflict with the current state of the resource.
- `422`: The server understood the request but it was unable to process the contained instructions.

## Changes

- **2026-10-29** `30a51d431498`: 1 info
  - api operation id `postApplicationsByApplicationIdPersonas` was added
- **2026-10-06** `a8cd2358644e`: 3 breaking, 3 warning, 3 info
  - added `#/components/schemas/undefined_ApplicationPersonaMaritalPartnerInput` to the `maritalPartner` request property `allOf` list
  - added `#/components/schemas/undefined_PhoneInputDto` to the `primaryPhoneNumber` request property `allOf` list
  - added `#/components/schemas/undefined_PhoneInputDto` to the `secondaryPhoneNumber` request property `allOf` list
  - removed `#/components/schemas/undefined_PersonaMaritalPartnerDto` from the `maritalPartner` request property `allOf` list
  - …5 more
- **2026-09-22** `347fae53b9dd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/goodleap/apis/developer-api/changes/posfinancing/rest/v2/applications/:applicationId/personas/post.md)

---

[API](https://skmtc.dev/goodleap/apis/developer-api.md) - [All operations](https://skmtc.dev/goodleap/apis/developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/goodleap/apis/developer-api/revisions/30a51d431498?raw)