All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
8.1.1 (2025-02-10)
- Updated supported enum values for webhook types in the
GET /webhooks
endpoint
8.1.0 (2025-02-06)
- Added “pipeline_id” query parameter to GET /api/v1/deals/summary endpoint
- Updated list of lead label colors to include 'brown', 'dark-gray', 'orange', 'pink'
8.0.0 (2025-01-30)
- Added compatibility for both API v1 and v2 endpoints. See migration guide for more details
- Add documentation for installments functionality:
POST
/v1/deals/{id}/products
endpointPUT
/v1/deals/{id}/products/{product_attachment_id}
endpointDELETE
/v1/deals/{id}/products/{product_attachment_id}
endpointPOST
/v2/deals/{id}/products
endpointPATCH
/v2/deals/{id}/products/{product_attachment_id}
endpointDELETE
/v2/deals/{id}/products/{product_attachment_id}
endpoint
- Added the field “notes” to product prices in the body and response for v1 and v2
- Added the field “overhead_cost” to the product variation prices in the response for v1
- Added the field “direct_cost” to the product variation prices in the response and body for v2
- Add "custom_fields" query paremeter to GET /api/v2/products
- Reduce maximum
limit
query param to 100 for the following endpoints- GET v1/files
- GET v1/deals/{id}/files
- GET v1/organizations/{id}/files
- GET v1/persons/{id}/files
- GET /v1/products/{id}/files
7.1.0 (2024-09-12)
- Added
notes
field to Prices in:GET
andPOST
/v2/products/{productId}/variations
endpointsPATCH
/api/v2/products/{productId}/variations/{productVariationId}
endpoint
- Notice informing the users of the upcoming Activity Invites feature deprecation:
POST
andPUT
/v1/activities
endpoints
- Fixed response schemas for GET
/v1/<entity>Fields
requests - Added missing "description" parameter to "Add a product" and "Update a product" endpoints
- Added the missing "label_ids" field to the contacts endpoints.
- Added "filter_id" to GET /api/v2/deals documentation
- Updated default values for "billing_frequency_cycles", "billing_start_date" fields
7.0.0 (2024-09-11)
- Removed request and response fields
duration
andduration_unit
for all endpoints of deals and products using them
6.10.1 (2024-06-07)
- Cleanup unused company settings
6.10.0 (2024-06-07)
Added acv
, mrr
, arr
, acv_currency
, mrr_currency
, and arr_currency
to the BaseDeal entity and the following endpoints' response:
GET
,POST
/v1/deals
GET
,PUT
/v1/deals/{id}
GET
/v1/deals/timeline
PUT
/v1/deals/{id}/merge
POST
/v1/deals/{id}/duplicate
6.9.0 (2024-05-30)
- Fixed documentation: property
value
of Lead is nullable.
6.8.1 (2024-05-29)
- Removed mention of address autocompletion by Google in Add Activities endpoint and other entities(organization, person, deal) fields.
6.8.0 (2024-05-22)
- Added
origin
,origin_id
,channel
andchannel_id
parameters representing the Source for Lead and Deal entity.
6.7.0 (2024-05-17)
- Added documentation for new endpoints
/deals/{id}/changelog
,/persons/{id}/changelog
and/organizations/{id}/changelog
. - Added
is_deleted
parameter for/v1/users/*
responses. - Added
billing_frequency
,billing_frequency_cycles
andbilling_start_date
fields toGET
,POST
andPUT
/v1/deals/{id}/products
endpointsGET
,POST
andPATCH
/v2/deals/{id}/products
endpointsGET
/v2/deals/products
endpoint
- Added
billing_frequency
,billing_frequency_cycles
fields toGET
,POST
andPUT
/v1/products
endpointsGET
/v1/products/{id}
endpointGET
,POST
andPATCH
/v2/products
endpointsGET
/v2/products/{id}
endpoints
- Added RawData trait to models to allow access to all response data objects
6.6.0 (2024-04-02)
- Documentation for new endpoint
/deals/{id}/participantsChangelog
6.5.1 (2024-04-02)
won_time
,lost_time
andclose_time
parameters for thePOST /v1/deals
andPUT /v1/deals/{id}
endpoints
6.5.0 (2024-04-02)
- Documentation for
/meetings/userProviderLinks
endpoints
6.4.0 (2024-04-02)
lead_id
as an acceptable body parameter for thePOST /v1/callLogs
endpoint
6.3.1 (2024-04-02)
- Mismatches of YAML responses in related_objects of some deal endpoints
6.3.0 (2023-10-16)
- Add
Projects
,ProjectTemplates
andTasks
public routes.
6.2.0 (2023-10-11)
- Document
label
parameter for the deal, person, org entities.
6.1.3 (2023-10-06)
- Incorrect type of
options
for thePOST and PUT /dealFields, /personFields and /organizationFields
endpoints
6.1.2 (2023-09-12)
- Fixed incorrect response schema for the
GET /deals/{id}/products
endpoint
6.1.1 (2023-09-12)
- Added further details on behavior of
end_date
forPUT /v1/subscriptions/recurring/{id}/cancel
6.1.0 (2023-09-05)
- Resolved namespace issues in
$openAPITypes
forProductAttachmentDetails
,AddProductAttachmentDetails
,BaseMailThread
, andFieldTypeAsString
(#91) models
6.0.0 (2023-08-30)
- Removed request and response fields
sum_no_discount
forGET /deals/{id}/products
,POST /deals/{id}/products
andPUT /deals/{id}/products/{product_attachment_id}
5.1.0 (2023-08-30)
- Fixed incorrect parameter descriptions for the
PUT /deals/{id}
endpoint
5.0.0 (2023-08-16)
Release a stable version of 5.0.0 which is a complete rewrite of the client-php. With version 5 of the SDK, we have moved to an open-source SDK generator called OpenAPI Generator.
5.0.0-beta.1 (2023-07-24)
- Added list of searchable custom field types to persons, organizations, products and deals search endpoints descriptions.
- Changed
product_id
body parameter to be optional for Update Deal Product endpoint - Schemas for
call-logs
as they only includedbase-response
without additional properties in the response schema
5.0.0-beta.0 (2023-06-14)
- Breaking switch to SDK generated with openapi-generator