Saltar al contenido principal
PUT
/
crm
/
v3
/
lists
/
{listId}
/
schedule-conversion
Programar o actualizar la conversión de una lista en estática
curl --request PUT \
  --url https://api.hubapi.com/crm/v3/lists/{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
  }
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito
Esta API requiere uno de los siguientes ámbitos:
cms.membership.access_groups.write
crm.lists.read
crm.lists.write

Autorizaciones

Authorization
string
header
requerido

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

Parámetros de ruta

listId
string
requerido

El ID de la lista para la que se va a programar la conversión.

Cuerpo

application/json
conversionType
enum<string>
predeterminado:CONVERSION_DATE
requerido

Especifica el tipo de conversión (CONVERSION_DATE).

Opciones disponibles:
CONVERSION_DATE
day
integer<int32>
requerido

El componente de día de la fecha de conversión.

month
integer<int32>
requerido

El componente de mes de la fecha de conversión.

year
integer<int32>
requerido

El componente de año de la fecha de conversión.

Respuesta

successful operation

listId
string
requerido

El identificador único de la lista para la que se proporcionan los detalles de la conversión.

convertedAt
string<date-time>

La fecha y hora en que la lista se convirtió.

requestedConversionTime
CONVERSION_DATE · object

La hora programada para la conversión de la lista, que puede basarse en una fecha específica o en un período de inactividad.

Last modified on March 30, 2026