Sendgrid Migration Guide
Upgrading to 1.0.0
This release makes several changes that upgrade the Sendgrid connector.
- The configuration options have been renamed to
api_key
andstart_date
. - The
unsubscribe_groups
stream has been removed. It was the same assuppression_groups
. You can use that and get the same data. - The
single_sends
stream has been renamedsinglesend_stats
. This is closer to the data and API. - The
segments
stream has been upgraded to use the Sendgrid 2.0 API because the older one has been deprecated. The schema has changed as a result.
To ensure a smooth upgrade, please refresh your schemas and reset your data before resuming syncs.
Connector Upgrade Guide
For Airbyte Open Source: Update the local connector image
Airbyte Open Source users must manually update the connector image in their local registry before proceeding with the migration. To do so:
- Select Settings in the main navbar.
- Select Sources.
- Find Sendgrid in the list of connectors.
You will see two versions listed, the current in-use version and the latest version available.
- Select Change to update your OSS version to the latest available version.
Update the connector version
- Select Sources in the main navbar.
- Select the instance of the connector you wish to upgrade.
Each instance of the connector must be updated separately. If you have created multiple instances of a connector, updating one will not affect the others.
- Select Upgrade
- Follow the prompt to confirm you are ready to upgrade to the new version.
Refresh all schemas and reset data
- Select Connections in the main navbar.
- Select the connection(s) affected by the update.
- Select the Replication tab.
- Select Refresh source schema.
- Select OK.
Any detected schema changes will be listed for your review.
- Select Save changes at the bottom of the page.
- Ensure the Reset all streams option is checked.
- Select Save connection.
This will reset the data in your destination and initiate a fresh sync.
For more information on resetting your data in Airbyte, see this page.
Refresh affected schemas and reset data
- Select Connections in the main navbar.
- Select the connection(s) affected by the update.
- Select the Replication tab.
- Select Refresh source schema.
- Select OK.
Any detected schema changes will be listed for your review.
- Select Save changes at the bottom of the page.
- Ensure the Reset affected streams option is checked.
Depending on destination type you may not be prompted to reset your data.
- Select Save connection.
This will reset the data in your destination and initiate a fresh sync.
For more information on resetting your data in Airbyte, see this page.