Skip to main content
PUT
/
crm
/
lists
/
2026-03
/
{listId}
/
schedule-conversion
cURL
curl --request PUT \
  --url https://api.hubapi.com/crm/lists/2026-03/{listId}/schedule-conversion \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversionType": "CONVERSION_DATE",
  "day": 123,
  "month": 123,
  "year": 123
}
'
{
  "listId": "<string>",
  "convertedAt": "2023-11-07T05:31:56Z",
  "requestedConversionTime": {
    "conversionType": "CONVERSION_DATE",
    "day": 123,
    "month": 123,
    "year": 123
  }
}

Supported products

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

listId
string
required

Body

application/json
conversionType
enum<string>
default:CONVERSION_DATE
required

Specifies the type of conversion (CONVERSION_DATE).

Available options:
CONVERSION_DATE
day
integer<int32>
required

The day component of the conversion date.

month
integer<int32>
required

The month component of the conversion date.

year
integer<int32>
required

The year component of the conversion date.

Response

successful operation

listId
string
required

The unique identifier of the list for which the conversion details are provided.

convertedAt
string<date-time>

The date and time when the list was converted.

requestedConversionTime
CONVERSION_DATE · object

The scheduled time for the list conversion, which can be based on a specific date or inactivity period.

Last modified on March 30, 2026