Update an Engagement

Last updated June 17, 2020

PUT /engagements/v1/engagements/:engagementId

Method Details

HTTP Methods:


Content Type:


Response Format:


Requires Authentication?


Rate Limited?





HubSpot CRM

Update an engagement (a task or activity) on an object in HubSpot.

Note: This endpoint will replace any existing metadata with the contents of the request. To merge the contents of the request with the engagement's existing metadata, consider using the PATCH endpoint instead.

Required Parameters How to use Description
OAuth Access Token or API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.
Used to authenticate the request. Please see this page for more details about authentication.
Engagement JSON Included in request body An object representing the engagement you have created.
metadata Included in request body You must include the metadata field when updating an engagement. Note: sending an empty metadata field will remove all details for the engagement.

Example URL to PUT to: https://api.hubapi.com/engagements/v1/engagements/74?hapikey=demo

Please see this page for more details about the data that can be used in engagements.