Advanced

Create

Changed on Oct 10, 2026

Create a new task series in the HubSpot CRM. This endpoint allows you to start a series of tasks by providing the necessary properties and series details. It is useful for automating repetitive task sequences within your CRM workflows.

post/crm/task-series/2026-09

Request

Base URL: https://api.hubapi.com
URL: https://api.hubapi.com/crm/task-series/2026-09
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)

Request body

propertiesobject required

A map of additional property names to their values, represented as a string-to-string object.

taskIdinteger required

The unique identifier for the task, represented as an integer in int64 format.

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