Build 337 - version-minor

CHANGELOG.md

@@ -5,6 +5,13 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+### Added
+- Added `website`, `linkedin`, `industry`, `annual_revenue`, and `employee_count` as writable fields to v2 organization request body (`POST /api/v2/organizations`, `PATCH /api/v2/organizations/{id}`)
+- Added `postal_address`, `notes`, `im`, `birthday`, and `job_title` as writable fields to v2 person request body (`POST /api/v2/persons`, `PATCH /api/v2/persons/{id}`) — these fields don't exist by default and are only created when contact sync is set up for the company
+- Updated `POST /api/v2/persons` and `PATCH /api/v2/persons/{id}` descriptions to clarify that the `im`, `postal_address`, `notes`, `birthday`, and `job_title` fields require contact sync to be set up
+### Fixed
+- Removed `update_time` from `POST /api/v2/organizations` and `POST /api/v2/persons` request body schemas, and removed `add_time`/`update_time` from `PATCH /api/v2/organizations/{id}` and `PATCH /api/v2/persons/{id}` request body schemas — these are server-generated fields that were never meant to be accepted as input
+- Added missing example values for `website`, `linkedin`, `industry`, `annual_revenue`, and `employee_count` to the v2 organization response example
 
 ## [17.3.0](https://github.com/pipedrive/client-php/compare17.2.1...17.3.0) (2026-04-06)
 

docs/versions/v1/Api/DealsApi.md

@@ -807,7 +807,7 @@ Name | Type | Description  | Notes
 ## `getDealMailMessages()`
 
 ```php
-getDealMailMessages($id, $start, $limit): \Pipedrive\versions\v1\Model\ListMailMessagesResponse
+getDealMailMessages($id, $start, $limit, $include_body): \Pipedrive\versions\v1\Model\ListMailMessagesResponse
 ```
 
 List mail messages associated with a deal
@@ -839,9 +839,10 @@ $apiInstance = new Pipedrive\versions\v1\Api\DealsApi(
 $id = 56; // int | The ID of the deal
 $start = 0; // int | Pagination start
 $limit = 56; // int | Items shown per page
+$include_body = new \Pipedrive\versions\v1\Model\\Pipedrive\versions\v1\Model\NumberBooleanDefault0(); // \Pipedrive\versions\v1\Model\NumberBooleanDefault0 | Whether to include the mail message body content in the response. `0` = Don't include, `1` = Include.
 
 try {
-    $result = $apiInstance->getDealMailMessages($id, $start, $limit);
+    $result = $apiInstance->getDealMailMessages($id, $start, $limit, $include_body);
     print_r($result);
 } catch (Exception $e) {
     echo 'Exception when calling DealsApi->getDealMailMessages: ', $e->getMessage(), PHP_EOL;
@@ -855,6 +856,7 @@ Name | Type | Description  | Notes
  **id** | **int**| The ID of the deal |
  **start** | **int**| Pagination start | [optional] [default to 0]
  **limit** | **int**| Items shown per page | [optional]
+ **include_body** | [**\Pipedrive\versions\v1\Model\NumberBooleanDefault0**](../Model/.md)| Whether to include the mail message body content in the response. `0` = Don't include, `1` = Include. | [optional]
 
 ### Return type
 

docs/versions/v1/Api/OrganizationsApi.md

@@ -357,7 +357,7 @@ Name | Type | Description  | Notes
 ## `getOrganizationMailMessages()`
 
 ```php
-getOrganizationMailMessages($id, $start, $limit): \Pipedrive\versions\v1\Model\ListMailMessagesResponse
+getOrganizationMailMessages($id, $start, $limit, $include_body): \Pipedrive\versions\v1\Model\ListMailMessagesResponse
 ```
 
 List mail messages associated with an organization
@@ -389,9 +389,10 @@ $apiInstance = new Pipedrive\versions\v1\Api\OrganizationsApi(
 $id = 56; // int | The ID of the organization
 $start = 0; // int | Pagination start
 $limit = 56; // int | Items shown per page
+$include_body = new \Pipedrive\versions\v1\Model\\Pipedrive\versions\v1\Model\NumberBooleanDefault0(); // \Pipedrive\versions\v1\Model\NumberBooleanDefault0 | Whether to include the mail message body content in the response. `0` = Don't include, `1` = Include.
 
 try {
-    $result = $apiInstance->getOrganizationMailMessages($id, $start, $limit);
+    $result = $apiInstance->getOrganizationMailMessages($id, $start, $limit, $include_body);
     print_r($result);
 } catch (Exception $e) {
     echo 'Exception when calling OrganizationsApi->getOrganizationMailMessages: ', $e->getMessage(), PHP_EOL;
@@ -405,6 +406,7 @@ Name | Type | Description  | Notes
  **id** | **int**| The ID of the organization |
  **start** | **int**| Pagination start | [optional] [default to 0]
  **limit** | **int**| Items shown per page | [optional]
+ **include_body** | [**\Pipedrive\versions\v1\Model\NumberBooleanDefault0**](../Model/.md)| Whether to include the mail message body content in the response. `0` = Don't include, `1` = Include. | [optional]
 
 ### Return type
 

docs/versions/v1/Api/PersonsApi.md

@@ -500,7 +500,7 @@ Name | Type | Description  | Notes
 ## `getPersonMailMessages()`
 
 ```php
-getPersonMailMessages($id, $start, $limit): \Pipedrive\versions\v1\Model\ListMailMessagesResponse
+getPersonMailMessages($id, $start, $limit, $include_body): \Pipedrive\versions\v1\Model\ListMailMessagesResponse
 ```
 
 List mail messages associated with a person
@@ -532,9 +532,10 @@ $apiInstance = new Pipedrive\versions\v1\Api\PersonsApi(
 $id = 56; // int | The ID of the person
 $start = 0; // int | Pagination start
 $limit = 56; // int | Items shown per page
+$include_body = new \Pipedrive\versions\v1\Model\\Pipedrive\versions\v1\Model\NumberBooleanDefault0(); // \Pipedrive\versions\v1\Model\NumberBooleanDefault0 | Whether to include the mail message body content in the response. `0` = Don't include, `1` = Include.
 
 try {
-    $result = $apiInstance->getPersonMailMessages($id, $start, $limit);
+    $result = $apiInstance->getPersonMailMessages($id, $start, $limit, $include_body);
     print_r($result);
 } catch (Exception $e) {
     echo 'Exception when calling PersonsApi->getPersonMailMessages: ', $e->getMessage(), PHP_EOL;
@@ -548,6 +549,7 @@ Name | Type | Description  | Notes
  **id** | **int**| The ID of the person |
  **start** | **int**| Pagination start | [optional] [default to 0]
  **limit** | **int**| Items shown per page | [optional]
+ **include_body** | [**\Pipedrive\versions\v1\Model\NumberBooleanDefault0**](../Model/.md)| Whether to include the mail message body content in the response. `0` = Don't include, `1` = Include. | [optional]
 
 ### Return type
 

docs/versions/v1/Model/MailMessageData.md

@@ -10,6 +10,7 @@ Name | Type | Description | Notes
 **cc** | [**\Pipedrive\versions\v1\Model\MailParticipant[]**](MailParticipant.md) | The array of mail message copies (object) | [optional]
 **bcc** | [**\Pipedrive\versions\v1\Model\MailParticipant[]**](MailParticipant.md) | The array of mail message blind copies (object) | [optional]
 **body_url** | **string** | The mail message body URL | [optional]
+**body** | **string** | The mail message body content. Only present when `include_body=1` is passed. | [optional]
 **account_id** | **string** | The connection account ID | [optional]
 **user_id** | **int** | ID of the user whom mail message will be assigned to | [optional]
 **mail_thread_id** | **int** | ID of the mail message thread | [optional]

docs/versions/v1/Model/MailMessageItemForList.md

@@ -10,6 +10,7 @@ Name | Type | Description | Notes
 **cc** | [**\Pipedrive\versions\v1\Model\MailParticipant[]**](MailParticipant.md) | The array of mail message copies (object) | [optional]
 **bcc** | [**\Pipedrive\versions\v1\Model\MailParticipant[]**](MailParticipant.md) | The array of mail message blind copies (object) | [optional]
 **body_url** | **string** | The mail message body URL | [optional]
+**body** | **string** | The mail message body content. Only present when `include_body=1` is passed. | [optional]
 **account_id** | **string** | The connection account ID | [optional]
 **user_id** | **int** | ID of the user whom mail message will be assigned to | [optional]
 **mail_thread_id** | **int** | ID of the mail message thread | [optional]

docs/versions/v2/Api/OrganizationsApi.md

@@ -19,7 +19,7 @@ Method | HTTP request | Description
 ## `addOrganization()`
 
 ```php
-addOrganization($organization_request_body): \Pipedrive\versions\v2\Model\PostPatchGetOrganization
+addOrganization($post_organization_request_body): \Pipedrive\versions\v2\Model\PostPatchGetOrganization
 ```
 
 Add a new organization
@@ -48,10 +48,10 @@ $apiInstance = new Pipedrive\versions\v2\Api\OrganizationsApi(
     new GuzzleHttp\Client(),
     $config
 );
-$organization_request_body = new \Pipedrive\versions\v2\Model\OrganizationRequestBody(); // \Pipedrive\versions\v2\Model\OrganizationRequestBody
+$post_organization_request_body = new \Pipedrive\versions\v2\Model\PostOrganizationRequestBody(); // \Pipedrive\versions\v2\Model\PostOrganizationRequestBody
 
 try {
-    $result = $apiInstance->addOrganization($organization_request_body);
+    $result = $apiInstance->addOrganization($post_organization_request_body);
     print_r($result);
 } catch (Exception $e) {
     echo 'Exception when calling OrganizationsApi->addOrganization: ', $e->getMessage(), PHP_EOL;
@@ -62,7 +62,7 @@ try {
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **organization_request_body** | [**\Pipedrive\versions\v2\Model\OrganizationRequestBody**](../Model/OrganizationRequestBody.md)|  | [optional]
+ **post_organization_request_body** | [**\Pipedrive\versions\v2\Model\PostOrganizationRequestBody**](../Model/PostOrganizationRequestBody.md)|  | [optional]
 
 ### Return type
 
@@ -656,7 +656,7 @@ Name | Type | Description  | Notes
 ## `updateOrganization()`
 
 ```php
-updateOrganization($id, $organization_request_body): \Pipedrive\versions\v2\Model\PostPatchGetOrganization
+updateOrganization($id, $update_organization_request_body): \Pipedrive\versions\v2\Model\PostPatchGetOrganization
 ```
 
 Update a organization
@@ -686,10 +686,10 @@ $apiInstance = new Pipedrive\versions\v2\Api\OrganizationsApi(
     $config
 );
 $id = 56; // int | The ID of the organization
-$organization_request_body = new \Pipedrive\versions\v2\Model\OrganizationRequestBody(); // \Pipedrive\versions\v2\Model\OrganizationRequestBody
+$update_organization_request_body = new \Pipedrive\versions\v2\Model\UpdateOrganizationRequestBody(); // \Pipedrive\versions\v2\Model\UpdateOrganizationRequestBody
 
 try {
-    $result = $apiInstance->updateOrganization($id, $organization_request_body);
+    $result = $apiInstance->updateOrganization($id, $update_organization_request_body);
     print_r($result);
 } catch (Exception $e) {
     echo 'Exception when calling OrganizationsApi->updateOrganization: ', $e->getMessage(), PHP_EOL;
@@ -701,7 +701,7 @@ try {
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **id** | **int**| The ID of the organization |
- **organization_request_body** | [**\Pipedrive\versions\v2\Model\OrganizationRequestBody**](../Model/OrganizationRequestBody.md)|  | [optional]
+ **update_organization_request_body** | [**\Pipedrive\versions\v2\Model\UpdateOrganizationRequestBody**](../Model/UpdateOrganizationRequestBody.md)|  | [optional]
 
 ### Return type
 

docs/versions/v2/Api/PersonsApi.md

@@ -20,12 +20,12 @@ Method | HTTP request | Description
 ## `addPerson()`
 
 ```php
-addPerson($person_request_body): \Pipedrive\versions\v2\Model\PostPatchGetPerson
+addPerson($post_person_request_body): \Pipedrive\versions\v2\Model\PostPatchGetPerson
 ```
 
 Add a new person
 
-Adds a new person. If the company uses the [Campaigns product](https://pipedrive.readme.io/docs/campaigns-in-pipedrive-api), then this endpoint will also accept and return the `marketing_status` field.
+Adds a new person. <br>If the company uses the [Campaigns product](https://pipedrive.readme.io/docs/campaigns-in-pipedrive-api), then this endpoint will also accept and return the `marketing_status` field. <br>The `im`, `postal_address`, `notes`, `birthday` and `job_title` fields don’t exist by default in Pipedrive and are only created when you set up your contact sync.
 
 ### Example
 
@@ -49,10 +49,10 @@ $apiInstance = new Pipedrive\versions\v2\Api\PersonsApi(
     new GuzzleHttp\Client(),
     $config
 );
-$person_request_body = new \Pipedrive\versions\v2\Model\PersonRequestBody(); // \Pipedrive\versions\v2\Model\PersonRequestBody
+$post_person_request_body = new \Pipedrive\versions\v2\Model\PostPersonRequestBody(); // \Pipedrive\versions\v2\Model\PostPersonRequestBody
 
 try {
-    $result = $apiInstance->addPerson($person_request_body);
+    $result = $apiInstance->addPerson($post_person_request_body);
     print_r($result);
 } catch (Exception $e) {
     echo 'Exception when calling PersonsApi->addPerson: ', $e->getMessage(), PHP_EOL;
@@ -63,7 +63,7 @@ try {
 
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
- **person_request_body** | [**\Pipedrive\versions\v2\Model\PersonRequestBody**](../Model/PersonRequestBody.md)|  | [optional]
+ **post_person_request_body** | [**\Pipedrive\versions\v2\Model\PostPersonRequestBody**](../Model/PostPersonRequestBody.md)|  | [optional]
 
 ### Return type
 
@@ -730,12 +730,12 @@ Name | Type | Description  | Notes
 ## `updatePerson()`
 
 ```php
-updatePerson($id, $person_request_body): \Pipedrive\versions\v2\Model\PostPatchGetPerson
+updatePerson($id, $update_person_request_body): \Pipedrive\versions\v2\Model\PostPatchGetPerson
 ```
 
 Update a person
 
-Updates the properties of a person. <br>If the company uses the [Campaigns product](https://pipedrive.readme.io/docs/campaigns-in-pipedrive-api), then this endpoint will also accept and return the `marketing_status` field.
+Updates the properties of a person. <br>If the company uses the [Campaigns product](https://pipedrive.readme.io/docs/campaigns-in-pipedrive-api), then this endpoint will also accept and return the `marketing_status` field. <br>The `im`, `postal_address`, `notes`, `birthday` and `job_title` fields don’t exist by default in Pipedrive and are only created when you set up your contact sync.
 
 ### Example
 
@@ -760,10 +760,10 @@ $apiInstance = new Pipedrive\versions\v2\Api\PersonsApi(
     $config
 );
 $id = 56; // int | The ID of the person
-$person_request_body = new \Pipedrive\versions\v2\Model\PersonRequestBody(); // \Pipedrive\versions\v2\Model\PersonRequestBody
+$update_person_request_body = new \Pipedrive\versions\v2\Model\UpdatePersonRequestBody(); // \Pipedrive\versions\v2\Model\UpdatePersonRequestBody
 
 try {
-    $result = $apiInstance->updatePerson($id, $person_request_body);
+    $result = $apiInstance->updatePerson($id, $update_person_request_body);
     print_r($result);
 } catch (Exception $e) {
     echo 'Exception when calling PersonsApi->updatePerson: ', $e->getMessage(), PHP_EOL;
@@ -775,7 +775,7 @@ try {
 Name | Type | Description  | Notes
 ------------- | ------------- | ------------- | -------------
  **id** | **int**| The ID of the person |
- **person_request_body** | [**\Pipedrive\versions\v2\Model\PersonRequestBody**](../Model/PersonRequestBody.md)|  | [optional]
+ **update_person_request_body** | [**\Pipedrive\versions\v2\Model\UpdatePersonRequestBody**](../Model/UpdatePersonRequestBody.md)|  | [optional]
 
 ### Return type
 

docs/versions/v2/Model/ActivityFieldItemOptions.md

@@ -4,7 +4,7 @@
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**id** | **int** | The option ID | [optional]
+**id** | [**OneOfIntegerString**](OneOfIntegerString.md) | The option ID (integer for custom fields, string for built-in fields) | [optional]
 **label** | **string** | The option display label | [optional]
 **color** | **string** | Optional color code for the option | [optional]
 **update_time** | **\DateTime** | When the option was last updated | [optional]

docs/versions/v2/Model/DealFieldItem.md

@@ -6,7 +6,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **field_name** | **string** | The display name/label of the field |
 **field_code** | **string** | The unique identifier for the field (40-character hash for custom fields) |
-**description** | **string** | The description of the field |
+**description** | **string** | The description of the field | [optional]
 **field_type** | **string** | The type of the field |
 **options** | [**\Pipedrive\versions\v2\Model\ActivityFieldItemOptions[]**](ActivityFieldItemOptions.md) | Array of available options for enum/set fields, null for other field types | [optional]
 **subfields** | [**\Pipedrive\versions\v2\Model\ActivityFieldItemSubfields[]**](ActivityFieldItemSubfields.md) | Array of subfields for complex field types (address, monetary), null for simple field types | [optional]

docs/versions/v2/Model/DeleteDealFieldData.md

@@ -6,7 +6,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **field_name** | **string** | The display name/label of the field |
 **field_code** | **string** | The unique identifier for the field (40-character hash for custom fields) |
-**description** | **string** | The description of the field |
+**description** | **string** | The description of the field | [optional]
 **field_type** | **string** | The type of the field |
 **options** | **object[]** | Array of available options for enum/set fields, null for other field types | [optional]
 **subfields** | **object[]** | Array of subfields for complex field types (address, monetary), null for simple field types | [optional]

docs/versions/v2/Model/Person.md

@@ -12,15 +12,15 @@ Name | Type | Description | Notes
 **org_id** | **int** | The ID of the organization linked to the person | [optional]
 **add_time** | **string** | The creation date and time of the person | [optional]
 **update_time** | **string** | The last updated date and time of the person | [optional]
-**emails** | [**\Pipedrive\versions\v2\Model\PersonEmails[]**](PersonEmails.md) | The emails of the person | [optional]
-**phones** | [**\Pipedrive\versions\v2\Model\PersonPhones[]**](PersonPhones.md) | The phones of the person | [optional]
+**emails** | [**\Pipedrive\versions\v2\Model\PersonItemEmail[]**](PersonItemEmail.md) | The emails of the person | [optional]
+**phones** | [**\Pipedrive\versions\v2\Model\PersonItemPhone[]**](PersonItemPhone.md) | The phones of the person | [optional]
 **is_deleted** | **bool** | Whether the person is deleted or not | [optional]
 **visible_to** | **int** | The visibility of the person | [optional]
 **label_ids** | **int[]** | The IDs of labels assigned to the person | [optional]
 **picture_id** | **int** | The ID of the picture associated with the person | [optional]
-**postal_address** | [**\Pipedrive\versions\v2\Model\PersonPostalAddress**](PersonPostalAddress.md) |  | [optional]
+**postal_address** | [**\Pipedrive\versions\v2\Model\PersonItemAddress**](PersonItemAddress.md) |  | [optional]
 **notes** | **string** | Contact sync notes of the person, maximum 10 000 characters, included if contact sync is enabled for the company | [optional]
-**im** | [**\Pipedrive\versions\v2\Model\PersonIm[]**](PersonIm.md) | The instant messaging accounts of the person, included if contact sync is enabled for the company | [optional]
+**im** | [**\Pipedrive\versions\v2\Model\PersonItemIm[]**](PersonItemIm.md) | The instant messaging accounts of the person, included if contact sync is enabled for the company | [optional]
 **birthday** | **string** | The birthday of the person, included if contact sync is enabled for the company | [optional]
 **job_title** | **string** | The job title of the person, included if contact sync is enabled for the company | [optional]
 **custom_fields** | **array<string,object>** | An object where each key represents a custom field. All custom fields are referenced as randomly generated 40-character hashes. To clear a custom field value, set it to &#x60;null&#x60;. For multi-option fields (field type &#x60;set&#x60;), use &#x60;null&#x60; to clear the selection — sending an empty array &#x60;[]&#x60; is not supported and will result in a validation error. | [optional]