---
title: "Schedule Conversion"
method: PUT
path: "/crm/lists/2026-09/{listId}/schedule-conversion"
tags: ["Basic"]
---

# Schedule Conversion

`PUT /crm/lists/2026-09/{listId}/schedule-conversion`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/crm/lists/2026-09/{listId}/schedule-conversion`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.lists.write`, `crm.segments.read`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `cms.membership.access_groups.write`, `crm.lists.read`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.segments.read`, `crm.segments.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.lists.read`, `crm.segments.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.lists.read`, `crm.lists.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `cms.membership.access_groups.write`, `crm.segments.read`

Schedule a conversion for a specific list in your HubSpot account. This operation allows you to set a conversion time for the list identified by the listId. Use this endpoint to manage the conversion schedule of your lists effectively.

## Path parameters

- `listId` string, required

## Request body

- union
  - object
    - `conversionType` 'CONVERSION_DATE', required: A string that indicates the type of conversion event. It specifies what kind of conversion has taken place.
    - `day` integer, required: An integer representing the day of the month when the conversion event occurred.
    - `month` integer, required: An integer representing the month of the year when the conversion event occurred.
    - `year` integer, required: An integer representing the year when the conversion event occurred.
  - object
    - `conversionType` 'INACTIVITY', required: A string that specifies the type of conversion, with a default value of 'INACTIVITY'.
    - `offset` integer, required: An integer indicating the offset value used in conjunction with the time unit to determine inactivity.
    - `timeUnit` 'DAY' | 'MONTH' | 'WEEK', required: A string representing the unit of time for measuring inactivity. Valid values include 'DAY', 'WEEK', and 'MONTH'.

## Response `200`

successful operation

- PublicListConversionResponse
  - `convertedAt` string, date-time: A string in date-time format indicating when the conversion was completed.
  - `listId` string, required: A string representing the unique identifier of the list that is being converted.
  - `requestedConversionTime` union: A string in date-time format indicating when the conversion was requested.
    - PublicListConversionDate
      - `conversionType` 'CONVERSION_DATE', required: A string that indicates the type of conversion event. It specifies what kind of conversion has taken place.
      - `day` integer, required: An integer representing the day of the month when the conversion event occurred.
      - `month` integer, required: An integer representing the month of the year when the conversion event occurred.
      - `year` integer, required: An integer representing the year when the conversion event occurred.
    - PublicListConversionInactivity
      - `conversionType` 'INACTIVITY', required: A string that specifies the type of conversion, with a default value of 'INACTIVITY'.
      - `offset` integer, required: An integer indicating the offset value used in conjunction with the time unit to determine inactivity.
      - `timeUnit` 'DAY' | 'MONTH' | 'WEEK', required: A string representing the unit of time for measuring inactivity. Valid values include 'DAY', 'WEEK', and 'MONTH'.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-10** (2026-09) `e1dd745172d1`: 2 info
  - the security scope `crm.lists.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `cms.membership.access_groups.write` was removed from the endpoint's security scheme `oauth2`
- **2026-09-07** (2026-09) `6d0e6dc36ca0`: 2 info
  - the security scope `crm.lists.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `cms.membership.access_groups.write` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/crm-lists/changes/crm/lists/2026-09/:listId/schedule-conversion/put.md)

---

[API](https://skmtc.dev/hubspot/apis/crm-lists.md) - [All operations](https://skmtc.dev/hubspot/apis/crm-lists/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/crm-lists/revisions/e1dd745172d1?raw)