Task series API (BETA) - HubSpot docs

Supported products

Scope requirements

Use the task series API to mark and manage regularly repeated tasks in HubSpot. By setting routine tasks as recurring, your sales reps can avoid setting manual reminders for themselves to stay up-to-date with their prospects and customers.

Set a task as recurring

To set an existing task as recurring, make a POST to /crm/task-series/2026-09-beta, and include the following properties in the body of your request:

Property	Type	Description
`taskId`	Number	The ID of an existing task that hasn’t yet been set to Repeating. You can use the tasks API to retrieve a list of tasks in your account, which you can use to get the ID of a specific task.
`series`	Object	An object that specifies the frequency and start time of the task series via the following properties: `repeatInterval`: the recurrence schedule as a standards-compliant RFC-5545 RRULE string. This string follows the format of `FREQ={TIME_PERIOD}`, where `TIME_PERIOD` can be `YEARLY`, `MONTHLY`, `WEEKLY`, `DAILY`. You can also set the frequency to every weekday using the format `FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR` `startsAt`: the date and time when the task series is scheduled to start, in ISO 8601 format. `repeatStatus`: a string representing the current status of the task series repetition, which should be set to `REPEATING`. If you stop a recurring task via the DELETE endpoint below, this field will automatically be updated to `STOPPED_BY_USER`.

For example, sending the following request body would set a task with an ID of 3774299725 to repeat weekly starting on August 15 2026:

{
  "taskId": 3774299725,
  "series": {
    "repeatInterval": "FREQ=WEEKLY",
    "startsAt": "2026-08-15T12:00:00Z",
    "repeatStatus": "REPEATING"
  }
}

A successful response will resemble the following:

{
  "id": "3774299725",
  "series": {
    "repeatInterval": "FREQ=WEEKLY",
    "startsAt": "2026-08-15T12:00:00Z",
    "repeatStatus": "REPEATING"
  },
  "properties": {
    "hs_task_family": "SALES",
    "hubspot_owner_id": "11045285",
    "hs_task_relative_reminders": "[]",
    "hs_task_type": "TODO",
    "hs_task_subject": "Changes requested",
    "hs_task_body": "Confirm all quote updates with Steve in accounting",
    "hs_task_priority": "NONE",
    "hs_task_template_id": "575837213828"
  },
  "createdAt": "2026-07-31T17:36:38.154Z",
  "updatedAt": "2026-07-31T17:36:38.154Z"
}

Retrieve a recurring task

To retrieve a recurring task by its ID, make a GET request to /crm/task-series/2026-09-beta/{taskId}. To locate a specific task by its ID, you can use the tasks API to retrieve a full list of existing tasks.

Update a recurring task

You can update a previously specified task series by making a PATCH request to /crm/task-series/2026-09-beta/{taskId}, and providing the scheduling changes within the series property in the body of your request. The fields of the series object are specified in the table above.

Stop a recurring task

To stop a task series from recurring, make a DELETE request to /crm/task-series/2026-09-beta/{taskId}. A successful request will result in a 204 No Content response. If you retrieve the task series via the endpoint above, the repeatStatus field within the series property will be updated to STOPPED_BY_USER:

{
  "id": "3774299725",
  "series": {
    "repeatInterval": "FREQ=WEEKLY",
    "startsAt": "2026-08-15T12:00:00Z",
    "repeatStatus": "STOPPED_BY_USER"
  },
  "properties": {
    "hs_task_family": "SALES",
    "hubspot_owner_id": "11045285",
    "hs_task_relative_reminders": "[]",
    "hs_task_type": "TODO",
    "hs_task_subject": "Changes requested",
    "hs_task_body": "Confirm all quote updates with Steve in accounting",
    "hs_task_priority": "NONE",
    "hs_task_template_id": "575837213828"
  },
  "createdAt": "2026-07-31T17:36:38.154Z",
  "updatedAt": "2026-07-31T18:11:57.955Z"
}

​Set a task as recurring

​Retrieve a recurring task

​Update a recurring task

​Stop a recurring task

Set a task as recurring

Retrieve a recurring task

Update a recurring task

Stop a recurring task