> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Schedule or update the conversion of a segment to static

> Planifiez une conversion pour une liste spécifique dans votre compte HubSpot. Cette opération vous permet de définir une heure de conversion pour la liste identifiée par l'id de liste. Utilisez ce point de terminaison pour gérer efficacement le calendrier de conversion de vos listes.

> **Supported products**

> **Required Scopes**


## OpenAPI

````yaml specs/2026-09/crm-lists-v2026-09.json PUT /crm/lists/2026-09/{listId}/schedule-conversion
openapi: 3.0.1
info:
  title: CRM Lists
  description: Basepom for all HubSpot Projects
  version: 2026-09
  x-hubspot-product-tier-requirements:
    marketing: FREE
    sales: FREE
    service: FREE
    cms: FREE
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Basic
  - name: Batch
  - name: Search
paths:
  /crm/lists/2026-09/{listId}/schedule-conversion:
    put:
      tags:
        - Basic
      summary: Planifier la conversion
      description: >-
        Planifiez une conversion pour une liste spécifique dans votre compte
        HubSpot. Cette opération vous permet de définir une heure de conversion
        pour la liste identifiée par l'id de liste. Utilisez ce point de
        terminaison pour gérer efficacement le calendrier de conversion de vos
        listes.
      operationId: put-/crm/lists/2026-09/{listId}/schedule-conversion
      parameters:
        - name: listId
          in: path
          description: >-
            L'identifiant unique de la liste pour laquelle le calendrier de
            conversion doit être défini.
          required: true
          style: simple
          explode: false
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PublicListConversionTime'
        required: true
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicListConversionResponse'
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security:
        - oauth2:
            - crm.lists.write
            - crm.segments.read
        - oauth2:
            - cms.membership.access_groups.write
            - crm.lists.read
        - oauth2:
            - crm.segments.read
            - crm.segments.write
        - oauth2:
            - crm.lists.read
            - crm.segments.write
        - oauth2:
            - crm.lists.read
            - crm.lists.write
        - oauth2:
            - cms.membership.access_groups.write
            - crm.segments.read
components:
  schemas:
    PublicListConversionTime:
      properties: {}
      oneOf:
        - $ref: '#/components/schemas/PublicListConversionDate'
        - $ref: '#/components/schemas/PublicListConversionInactivity'
    PublicListConversionResponse:
      required:
        - listId
      type: object
      properties:
        convertedAt:
          type: string
          description: >-
            Chaîne au format date-heure indiquant quand la conversion a été
            effectuée.
          format: date-time
        listId:
          type: string
          description: >-
            Une chaîne représentant l'identifiant unique de la liste en cours de
            conversion.
        requestedConversionTime:
          description: >-
            Chaîne au format date-heure indiquant quand la conversion a été
            demandée.
          oneOf:
            - $ref: '#/components/schemas/PublicListConversionDate'
            - $ref: '#/components/schemas/PublicListConversionInactivity'
    PublicListConversionDate:
      required:
        - conversionType
        - day
        - month
        - year
      type: object
      properties:
        conversionType:
          type: string
          description: >-
            Une chaîne de caractères qui indique le type d'événement de
            conversion. Elle spécifie le type de conversion qui a eu lieu.
          default: CONVERSION_DATE
          enum:
            - CONVERSION_DATE
        day:
          type: integer
          description: >-
            Un entier représentant le jour du mois où l'événement de conversion
            s'est produit.
          format: int32
        month:
          type: integer
          description: >-
            Un entier représentant le mois de l'année où l'événement de
            conversion s'est produit.
          format: int32
        year:
          type: integer
          description: >-
            Un entier représentant l'année où l'événement de conversion s'est
            produit.
          format: int32
      x-hubspot-sub-type-impl: true
    PublicListConversionInactivity:
      required:
        - conversionType
        - offset
        - timeUnit
      type: object
      properties:
        conversionType:
          type: string
          description: "Une chaîne qui spécifie le type de conversion, avec une valeur par défaut de «\_INACTIVITY\_»."
          default: INACTIVITY
          enum:
            - INACTIVITY
        offset:
          type: integer
          description: >-
            Un entier indiquant la valeur de décalage utilisée conjointement
            avec l'unité de temps pour déterminer l'inactivité.
          format: int32
        timeUnit:
          type: string
          description: "Une chaîne représentant l'unité de temps pour mesurer l'inactivité. Les valeurs valides incluent «\_JOUR\_», «\_SEMAINE\_» et «\_MOIS\_»."
          enum:
            - DAY
            - MONTH
            - WEEK
      x-hubspot-sub-type-impl: true
    Error:
      required:
        - category
        - correlationId
        - message
      type: object
      properties:
        category:
          type: string
          description: Une chaîne indiquant la catégorie de l'erreur.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >-
            Un objet contenant un contexte additionnel sur l'erreur, représenté
            sous forme de carte de paires clé-valeur.
          example: >-
            {invalidPropertyName=[propertyValue], missingScopes=[scope1,
            scope2]}
        correlationId:
          type: string
          description: >-
            Un identifiant unique pour l'instance d'erreur, utilisé à des fins
            de suivi et de débogage.
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: >-
            Un tableau d'objets ErrorDetail, chacun fournissant des informations
            supplémentaires sur les erreurs spécifiques qui se sont produites.
          items:
            $ref: '#/components/schemas/ErrorDetail'
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            Un objet contenant des liens connexes, représenté sous forme de
            mappage des noms de liens vers des URL.
        message:
          type: string
          description: >-
            Une chaîne qui fournit une description de l'erreur lisible par un
            humain.
          example: An error occurred
        subCategory:
          type: string
          description: >-
            Un objet représentant une classification plus spécifique de l'erreur
            au sein de sa catégorie.
      description: >-
        Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération
        échoue. Ce composant est utilisé dans divers points de terminaison pour
        fournir des informations détaillées sur l'erreur rencontrée.
      example:
        message: Invalid input (details will vary based on the error)
        correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
        category: VALIDATION_ERROR
        links:
          knowledge-base: https://www.hubspot.com/products/service/knowledge-base
    ErrorDetail:
      required:
        - message
      type: object
      properties:
        code:
          type: string
          description: >-
            Une chaîne représentant un code d'erreur spécifique qui identifie le
            type d'erreur.
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: >-
            Un objet contenant un contexte additionnel sur l'erreur, représenté
            comme une carte de chaînes de caractères vers des tableaux de
            chaînes de caractères, qui peut inclure des paramètres ou des
            valeurs spécifiques liés à l'erreur.
          example: '{missingScopes=[scope1, scope2]}'
        in:
          type: string
          description: "Une chaîne indiquant l'emplacement où l'erreur s'est produite, tel que «\_query\_», «\_header\_» ou «\_body\_»."
        message:
          type: string
          description: Une chaîne contenant une description de l'erreur lisible.
        subCategory:
          type: string
          description: >-
            Un objet fournissant une catégorisation supplémentaire de l'erreur,
            qui peut contenir des détails supplémentaires.
      description: >-
        Représente des informations détaillées sur une erreur survenue dans
        l'API. Ce composant est utilisé pour fournir un contexte et des
        spécificités supplémentaires sur les erreurs, généralement dans le cadre
        d'une réponse d'erreur.
  responses:
    Error:
      description: An error occurred.
      content:
        '*/*':
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://app.hubspot.com/oauth/authorize
          tokenUrl: https://api.hubapi.com/oauth/v1/token
          scopes:
            cms.membership.access_groups.write: ''
            crm.lists.read: ''
            crm.lists.write: ''
            crm.segments.read: ''
            crm.segments.write: ''

````