V2 Open API Spec incorrect for "Add a new person"

integration-tester
Tue, 17 Mar 2026 08:54:18 +0000
API

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
}

2 posts - 2 participants