The official V2 Open API Spec for “Add a new person” specifies title as a required field. However it is not required, and including it in a request returns a 400 error.
Open API Spec excerpt, note the last 2 lines:
post:
summary: Add a new person
description: ‘Adds a new person. If the company uses the [Campaigns product](Campaigns in Pipedrive API), then this endpoint will also accept and return the `marketing_status` field.’
x-token-cost: 5
operationId: addPerson
tags:
- Persons
security:
- api_key: []
- oauth2:
- ‘contacts:full’
requestBody:
content:
application/json:
schema:
required:
- title
Including title in the request produces the following response
{
“code”: “ERR_SCHEMA_VALIDATION_FAILED”,
“error”: “Validation failed: title: Parameter ‘title’ is not allowed for this request”,
“success”: false
}