For AI agents: markdown of this page — /docs-content-en/entities/person-types/create.md documentation index — /llms.txt

Create: Payer types

POST /v1/person-types

Required fields: name.

Terminal

curl -X POST "https://vibecode.bitrix24.com/v1/person-types" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Example payer","code":"EXAMPLE_PERSON","active":false}'

Missing record: 404. Invalid input: 400 before dispatch. Business refusal: 422 with the Bitrix24 message. Writing with a READONLY key: 403. See contract and limits.