---
title: "/people/{vanId}/names"
method: PATCH
path: "/people/{vanId}/names"
---

# /people/{vanId}/names

`PATCH /people/{vanId}/names`

## Request

- Base URL: `https://api.securevan.com/v4`
- URL: `https://api.securevan.com/v4/people/{vanId}/names`
- Auth: HTTP basic

## Path parameters

- `vanId` string, required

## Request body

- object
  - `title` string: Optional; an honorific
  - `firstName` string: Optional; a person’s first name
  - `middleName` string: Optional; a person’s middle name
  - `lastName` string: Optional; a person’s last name
  - `suffix` string: Optional; part of name following last name, e.g. "Jr."
  - `professionalSuffix` string: Optional; a person's professional suffix, e.g. "M.D."
  - `nickname` string: Optional; a person's preferred informal name
  - `salutation` string: Optional; preferred greeting for correspondence; defaults to a person's `firstName`
  - `additionalSalutation` string: Optional; additional preferred greeting for correspondence; defaults to `organizationContactCommonName` for organizations
  - `formalSalutation` string: Optional; preferred formal greeting for correspondence; defaults to `title` and `lastName` for people or "Friends" for organizations
  - `envelopeName` string: Optional; preferred name to use for mailings; defaults to the person's full name, including their middle initial, or `organizationContactCommonName` depending on the contact type
  - `formalEnvelopeName` string: Optional; preferred formal name to use for mailings; defaults to the person's full name, including their middle initial, title, and suffix, or `organizationContactOfficialName` depending on the contact type
  - `additionalEnvelopeName` string: Optional; additional preferred name to use for mailings
  - `pronouns` string: Optional; a person's pronouns
  - `organizationContactCommonName` string: Optional; an organization's common name
  - `organizationContactOfficialName` string: Optional; an organization's official name

## Response `200`

200

- object
  - `vanId` integer
  - `firstName` string
  - `lastName` string
  - `middleName` string
  - `suffix` string
  - `title` string
  - `sourceFileTitle` unknown
  - `sourceFileFirstName` unknown
  - `sourceFileMiddleName` unknown
  - `sourceFileLastName` unknown
  - `sourceFileSuffix` unknown
  - `contactMode` string
  - `organizationContactCommonName` unknown
  - `organizationContactOfficialName` unknown
  - `salutation` string
  - `formalSalutation` string
  - `additionalSalutation` unknown
  - `pronouns` object
    - `pronounId` integer
    - `pronounName` string
  - `envelopeName` string
  - `formalEnvelopeName` string
  - `additionalEnvelopeName` unknown
  - `contactMethodPreferenceCode` unknown
  - `nickname` string
  - `website` unknown
  - `professionalSuffix` string
  - `party` unknown
  - `employer` unknown
  - `occupation` unknown
  - `sex` unknown
  - `dateOfBirth` unknown
  - `selfReportedRace` unknown
  - `selfReportedEthnicity` unknown
  - `selfReportedRaces` unknown
  - `selfReportedEthnicities` unknown
  - `selfReportedGenders` unknown
  - `selfReportedSexualOrientations` unknown
  - `selfReportedLanguagePreference` unknown
  - `emails` unknown
  - `phones` unknown
  - `addresses` unknown
  - `recordedAddresses` unknown
  - `identifiers` unknown
  - `codes` unknown
  - `customFields` unknown
  - `primaryCustomField` unknown
  - `contributionSummary` unknown
  - `suppressions` unknown
  - `caseworkCases` unknown
  - `caseworkIssues` unknown
  - `caseworkStories` unknown
  - `notes` unknown
  - `scores` unknown
  - `customProperties` unknown
  - `electionRecords` unknown
  - `membershipStatus` unknown
  - `organizationRoles` unknown
  - `districts` unknown
  - `surveyQuestionResponses` unknown
  - `finderNumber` unknown
  - `biographyImageUrl` unknown
  - `primaryContact` unknown

## Other responses

- `400`: 400
- `404`: 404

## Changes

- **2026-11-03** `4f2049fba5af`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ngpvan/apis/van-crm/changes/people/:vanId/names/patch.md)

---

[API](https://skmtc.dev/ngpvan/apis/van-crm.md) - [All operations](https://skmtc.dev/ngpvan/apis/van-crm/llms.txt) - [OpenAPI document](https://skmtc.dev/ngpvan/apis/van-crm/revisions/4f2049fba5af?raw)