DeprecatrAI

v3

Released 2021-04-15Active
Migration Effort
Medium
Estimated Hours
~20h
Primary risk if skipped: Interruption of data synchronization and potential data loss due to changes in deletion behavior.

Breaking Changes3

endpointHighCRM

/crm/v3/objects/{objectType}/{objectId}

The deletion behavior for CRM objects has changed. Previously, deleting a contact or company would also delete associated records without confirmation. Now, deletion requires explicit confirmation, and associated records are not automatically deleted, preventing accidental data loss.

Before
DELETE /crm/v1/objects/contacts/{contactId}
After
DELETE /crm/v3/objects/contacts/{contactId}

Update delete calls to include the confirmation query parameter if necessary and handle potential changes in associated record behavior.

endpointHighCRM

/crm/v3/objects/contacts, /crm/v3/objects/companies

The endpoints for managing contacts and companies have been consolidated under the general CRM objects API. This restructuring simplifies the API surface but requires updating calls that previously used specific /contacts or /companies endpoints.

Before
/contacts/v1/contact
After
/crm/v3/objects/contacts/{objectId}

Migrate all calls from legacy contact and company endpoints to the new unified /crm/v3/objects/{objectType} endpoints.

fieldMediumCRM

id

The primary identifier field for all CRM objects is now consistently named 'id'. Previously, some objects might have used different naming conventions for their unique identifiers. This standardization ensures a predictable way to reference object IDs across the API.

Before
Unique identifier field (e.g., 'contactId', 'companyId')
After
id

Update all references to object IDs to use the 'id' field name instead of older, object-specific names.

Never get blindsided by an API change again

Deprecatr AI monitors 150+ providers, maps changes to your codebase, and delivers migration checklists before your team hits a breaking change.

Join the Waitlist