Update: maintenance is complete!
The Engagements API will be undergoing maintenance between 5:00 PM and 6:00 PM Eastern Time Sunday, September 15. During this maintenance period, there will be a brief period where the Engagements API will be unavailable, and any requests to the API will result in 500 errors. We expect this period to last less than 2 minutes, but during this period any attempts to create, update, or fetch timeline events will fail, and those requests will need to be retried.
If your integration retries on 5xx errors, then you shouldn't need to make any major changes for this, as long as your retry period lasts for at least 2 minutes.
If your integration does not currently retry on 5xx errors, then these requests will fail. Updates will not be queued or retried from HubSpot's side, so you will need to log these failed requests and replay them to make sure that all engagements get created. As a best practice, make sure to set the timestamp to when the event originally occurred
If you have any questions, please join the discussion in the community, where our developer support team will be available to answer your questions.
Note: A previous announcement listed the date as September 8. The date for this maintenance has been changed to September 15. The time and other details are the same as the original announcement.