Skip to content

Remove engagement, contact list deprecated fields + old was_unsubscribed field in email events#194

Merged
fivetran-avinash merged 23 commits intomainfrom
sunset/deprecation-fields
Feb 4, 2026
Merged

Remove engagement, contact list deprecated fields + old was_unsubscribed field in email events#194
fivetran-avinash merged 23 commits intomainfrom
sunset/deprecation-fields

Conversation

@fivetran-avinash
Copy link
Contributor

@fivetran-avinash fivetran-avinash commented Jan 24, 2026

PR Overview

Package version introduced in this PR:

  • 1.7.0

This PR addresses the following Issue/Feature(s):

Summary of changes:

  • Deprecation of columns no longer supported in Hubspot v3 API.

Submission Checklist

  • Alignment meeting with the reviewer (if needed)
    • Timeline and validation requirements discussed
  • Provide validation details:
    • Validation Steps: Check for unintentional effects (e.g., add/run consistency & integrity tests)
    • Testing Instructions: Confirm the change addresses the issue(s)
    • Focus Areas: Complex logic or queries that need extra attention
  • Merge any relevant open PRs into this PR

Changelog

  • Draft changelog for PR
  • Final changelog for release review

@fivetran-avinash fivetran-avinash changed the title remove contact list deprecated fields + old was_unsubscribed field Remove engagement, contact list deprecated fields + old was_unsubscribed field in email events Jan 29, 2026
@fivetran-avinash fivetran-avinash self-assigned this Jan 29, 2026
@fivetran-avinash fivetran-avinash added the docs:ready Triggers the docs generator workflow. label Jan 29, 2026
@fivetran-avinash fivetran-avinash added docs:ready Triggers the docs generator workflow. and removed docs:ready Triggers the docs generator workflow. labels Jan 29, 2026
@fivetran-avinash fivetran-avinash added docs:ready Triggers the docs generator workflow. and removed docs:ready Triggers the docs generator workflow. labels Jan 29, 2026
@fivetran-avinash fivetran-avinash added docs:ready Triggers the docs generator workflow. and removed docs:ready Triggers the docs generator workflow. labels Jan 29, 2026
@fivetran-avinash fivetran-avinash added docs:ready Triggers the docs generator workflow. and removed docs:ready Triggers the docs generator workflow. labels Jan 29, 2026
@fivetran-avinash fivetran-avinash added docs:ready Triggers the docs generator workflow. and removed docs:ready Triggers the docs generator workflow. labels Jan 29, 2026
@fivetran-avinash fivetran-avinash marked this pull request as ready for review January 30, 2026 18:41
CHANGELOG.md Outdated

| Data Model(s) | Change type | Old | New | Notes |
| ---------- | ----------- | -------- | -------- | ----- |
| `hubspot__email_sends` | Removed column | `was_unsubcribed` | | Field deprecated in [v1.5.0](https://github.com/fivetran/dbt_hubspot/releases/tag/v1.5.0) has been sunset. Use `was_unsubscribed` instead. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would just emphasize it is a spelling correction.

Suggested change
| `hubspot__email_sends` | Removed column | `was_unsubcribed` | | Field deprecated in [v1.5.0](https://github.com/fivetran/dbt_hubspot/releases/tag/v1.5.0) has been sunset. Use `was_unsubscribed` instead. |
| `hubspot__email_sends` | Removed column | `was_unsubcribed` | | Field deprecated in [v1.5.0](https://github.com/fivetran/dbt_hubspot/releases/tag/v1.5.0) has been sunset. Use the corrected spelling `was_unsubscribed` instead. |

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed.

CHANGELOG.md Outdated
| Data Model(s) | Change type | Old | New | Notes |
| ---------- | ----------- | -------- | -------- | ----- |
| `hubspot__email_sends` | Removed column | `was_unsubcribed` | | Field deprecated in [v1.5.0](https://github.com/fivetran/dbt_hubspot/releases/tag/v1.5.0) has been sunset. Use `was_unsubscribed` instead. |
| `hubspot__engagements` | Removed columns | `owner_id`<br>`is_active`<br>`created_timestamp`<br>`occurred_timestamp`<br>`activity_type`<br>`last_updated_timestamp` | | Fields deprecated for HubSpot v3 API connectors have been sunset. The `engagement` source table now only contains `type`, `id`, `_fivetran_synced`, `portal_id`, and `source_relation`. All engagement properties (timestamps, owner, status) are available in child engagement tables (e.g., `hubspot__engagement_emails`, `hubspot__engagement_notes`). Junction table aggregations (`contact_ids`, `deal_ids`, `company_ids`) remain available in `hubspot__engagements`. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If there is a link that talks about the v3 deprecations, let's link that.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added links to relevant release notes in each row.

select
{{ dbt_utils.star(from=base_model, relation_alias="base",except=["_fivetran_deleted", "created_timestamp", "occurred_timestamp", "owner_id"]) }},
select
{{ dbt_utils.star(from=base_model, relation_alias="base", except=["_fivetran_deleted", "created_timestamp", "occurred_timestamp", "owner_id"]) }},
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know we discussed this at standup, but I'm not seeing the risk in streamlining this a bit. The compiled code is effectively the same since unless I'm missing something.

Suggested change
{{ dbt_utils.star(from=base_model, relation_alias="base", except=["_fivetran_deleted", "created_timestamp", "occurred_timestamp", "owner_id"]) }},
{{ dbt_utils.star(from=base_model, relation_alias="base", except=["_fivetran_deleted"]) }},

Copy link
Contributor Author

@fivetran-avinash fivetran-avinash Feb 2, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Found some earlier notes that confirmed that these fields are fully sunset, so I went ahead and removed everything from the except statement besides _fivetran_deleted.

Comment on lines +21 to +23
base.created_timestamp,
base.occurred_timestamp,
base.owner_id
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this might be a bit confusing if we don't remove them in the future, but again let me know if this must stay. If they have to stay I would add a comment as to why these are down here.

Suggested change
base.created_timestamp,
base.occurred_timestamp,
base.owner_id

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Went ahead and removed.

@fivetran-avinash fivetran-avinash added docs:ready Triggers the docs generator workflow. and removed docs:ready Triggers the docs generator workflow. labels Feb 2, 2026
Copy link
Contributor Author

@fivetran-avinash fivetran-avinash left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@fivetran-catfritz Suggested changes applied, should be ready for re-review when you get back!

Copy link
Contributor

@fivetran-catfritz fivetran-catfritz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A few changelog suggestions but otherwise approved!

Co-authored-by: fivetran-catfritz <111930712+fivetran-catfritz@users.noreply.github.com>
@fivetran-avinash fivetran-avinash added docs:ready Triggers the docs generator workflow. and removed docs:ready Triggers the docs generator workflow. labels Feb 4, 2026
@fivetran-avinash fivetran-avinash merged commit 7c0c5ca into main Feb 4, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs:ready Triggers the docs generator workflow.

Projects

None yet

2 participants