What is changing?

1. We’re adding a new Labels field (label_ids), with the type set for the following Persons and Organizations API endpoints. The Labels field can store up to 100 values per entity.
• GET /v1/deals/{id}/participants
• GET /v1/organizations
• GET /v1/organizations/{id}
• GET /v1/organizations/{id}/persons
• POST /v1/organizations
• PUT /v1/organizations/{id}
• PUT /v1/organizations/{id}/merge
• GET /v1/persons
• GET /v1/persons/{id}
• POST /v1/persons
• PUT /v1/persons/{id}
• PUT /v1/persons/{id}/merge
2. The endpoints GET /v1/personFields and GET /v1/organizationFields will return the definition of these fields
3. The old Label field and the new Labels field are updated synchronously based on these rules:
• When the Labels field is updated, the Label field value will be set to the first value of the Labels field.
• When the Label field is updated, the Labels field value will be overwritten by the Label field value.

Why is this changing?

We’re changing the behavior of the existing Label field to prevent data inconsistency between the old and new fields.

If you have any questions or comments, please let us know in the Developer’s Community.