v3

Released 2016-01-01Active

← v2

Migration Effort

Medium

Estimated Hours

~20h

Primary risk if skipped: Reduced deliverability and potential disruption to marketing and transactional email sending.

Breaking Changes2

fieldHighMarketing Campaigns

global_unsubscribe_setting

The `global_unsubscribe_setting` field was removed from the Contacts API. This setting is now managed via the Suppression Management API.

Before

PATCH /v3/marketing_campaigns/{campaign_id} with body: { "global_unsubscribe_setting": true }

After

Use the Suppression Management API to manage global unsubscribe settings.

→

Migrate global unsubscribe management to the Suppression Management API.

endpointMediumEmail APIMarketing Campaigns

Tracking Settings

Legacy tracking settings endpoints under `/v3/tracking_settings/` are deprecated. All tracking settings should now be managed via specific sub-resources like `/v3/tracking_settings/click/`, `/v3/tracking_settings/open/`, etc.

Before

GET /v3/tracking_settings

After

GET /v3/tracking_settings/click

→

Update tracking settings API calls to use specific sub-resource endpoints.

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