Zum Hauptinhalt springen
PUT
/
crm
/
v3
/
lists
/
{listId}
/
schedule-conversion
Die Umwandlung einer Liste in eine statische planen oder aktualisieren
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
  }
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos
Diese API erfordert einen der folgenden Bereiche:
cms.membership.access_groups.write
crm.lists.read
crm.lists.write

Autorisierungen

Authorization
string
header
erforderlich

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

Pfadparameter

listId
string
erforderlich

Die ID der Liste, deren Umwandlung Sie planen möchten.

Body

application/json
conversionType
enum<string>
Standard:CONVERSION_DATE
erforderlich

Gibt den Umwandlungstyp an (CONVERSION_DATE).

Verfügbare Optionen:
CONVERSION_DATE
day
integer<int32>
erforderlich

Die Tageskomponente des Umwandlungsdatums.

month
integer<int32>
erforderlich

Die Monatskomponente des Umwandlungsdatums.

year
integer<int32>
erforderlich

Die Jahreskomponente des Umwandlungsdatums.

Antwort

successful operation

listId
string
erforderlich

Die eindeutige ID der Liste, für die die Umwandlungsdetails bereitgestellt werden.

convertedAt
string<date-time>

Der Zeitpunkt (Datum und Uhrzeit), zu dem die Liste umgewandelt wurde.

requestedConversionTime
CONVERSION_DATE · object

Der geplante Zeitpunkt für die Listenumwandlung, der auf einem bestimmten Datum oder einer bestimmten Inaktivitätsperiode basieren kann.

Last modified on March 24, 2026