Basic

Update task series

Changed on Oct 10, 2026

Update the details of a specific task series in your HubSpot account. This endpoint allows you to modify properties and series configurations for the task identified by the taskId. Use this to adjust task scheduling or update task-related information.

patch/crm/task-series/2026-09/{taskId}

Request

Base URL: https://api.hubapi.com
URL: https://api.hubapi.com/crm/task-series/2026-09/{taskId}
Auth: one of:
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.contacts.highly_sensitive.write.v2)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.commercepayments.write)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.goals.write)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.line_items.write)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.contacts.write)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.products.write)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.projects.write)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.contacts.sensitive.write.v2)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.services.write)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.projects.sensitive.write)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.deals.sensitive.write.v2)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: tickets.highly_sensitive.v2)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.listings.write)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.appointments.sensitive.write.v2)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.companies.write)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.courses.write)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.appointments.write)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: tickets.sensitive.v2)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.deals.write)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.projects.highly_sensitive.write)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.companies.sensitive.write.v2)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.deals.highly_sensitive.write.v2)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.objects.companies.highly_sensitive.write.v2)
- OAuth 2 (authorization code, authorization URL https://app.hubspot.com/oauth/authorize, token URL https://api.hubapi.com/oauth/v1/token, scopes: crm.schemas.tasks.write)

Path parameters

taskIdinteger required

The unique identifier of the task series to update.

Request body

propertiesobject

A map of additional property names to their values, represented as key-value pairs where both keys and values are strings.

Example request

{
  "series": {
    "repeatInterval": "RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR"
  }
}

Response

successful operation

createdAtstring date-time

The date and time when the task series was created, in ISO 8601 format.

idstring required

The unique identifier for the task series, represented as a string.

propertiesobject required

A map of custom property names to their values, where each value is a string.

updatedAtstring date-time

The date and time when the task series was last updated, in ISO 8601 format.

Example response

{
  "series": {
    "repeatInterval": "RRULE:FREQ=WEEKLY;BYDAY=MO,WE,FR"
  }
}

Changes

Oct 10, 20262026-09505bb3014904 Revision changes
- ○
  the security scope crm.objects.contacts.highly_sensitive.write.v2 was added to the endpoint's security scheme oauth2
- ○
  the security scope crm.schemas.tasks.write was removed from the endpoint's security scheme oauth2
Sep 8, 20262026-09c3e71e808c64 Revision changes
- ○
  the security scope crm.objects.contacts.highly_sensitive.write.v2 was added to the endpoint's security scheme oauth2
- ○
  the security scope tasks-write was removed from the endpoint's security scheme oauth2

Operation history