> ## 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. # Get accounts for a channel > Récupérer une liste de comptes pour un canal personnalisé. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-03/conversations-custom-channels-v2026-03.json GET /conversations/custom-channels/2026-03/{channelId}/channel-accounts openapi: 3.0.1 info: title: Conversations Custom Channels description: Basepom for all HubSpot Projects version: 2026-03 x-hubspot-product-tier-requirements: marketing: FREE sales: PROFESSIONAL service: PROFESSIONAL cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-api-use-case: >- Allow admins to install an integration with a third-party messaging channel that your team uses to communicate with customers, to allow users in your account to manage their conversations for that channel directly in HubSpot. x-hubspot-introduction: >- Use the custom channels API to create custom channels to build a bridge between an external message service and HubSpot's inbox or help desk features. servers: - url: https://api.hubapi.com security: [] tags: - name: Basic - name: Channel accounts - name: Channels - name: Messages paths: /conversations/custom-channels/2026-03/{channelId}/channel-accounts: get: tags: - Channel accounts summary: Obtenir les comptes d'un canal description: Récupérer une liste de comptes pour un canal personnalisé. operationId: get-/conversations/custom-channels/2026-03/{channelId}/channel-accounts parameters: - name: channelId in: path description: L'identifiant unique du canal pour lequel lister les comptes. required: true style: simple explode: false schema: type: integer format: int32 - name: after in: query description: >- Le jeton de curseur de pagination de la dernière ressource lue avec succès sera renvoyé en tant que propriété JSON `paging.next.after` d'une réponse paginée contenant plus de résultats. required: false style: form explode: true schema: type: string - name: archived in: query description: S'il faut renvoyer uniquement les résultats qui ont été archivés. required: false style: form explode: true schema: type: boolean - name: defaultPageLength in: query description: Le nombre par défaut de résultats à afficher par page. required: false style: form explode: true schema: type: integer format: int32 - name: deliveryIdentifierType in: query description: >- Un tableau de types d'identifiants de livraison pour filtrer les résultats. Les valeurs valides incluent HS_EMAIL_ADDRESS, HS_PHONE_NUMBER, HS_SHORT_CODE et CHANNEL_SPECIFIC_OPAQUE_ID. required: false style: form explode: true schema: type: array items: type: string enum: - HS_EMAIL_ADDRESS - HS_PHONE_NUMBER - HS_SHORT_CODE - CHANNEL_SPECIFIC_OPAQUE_ID - name: deliveryIdentifierValue in: query description: >- Un tableau de valeurs d'identifiants de livraison pour filtrer les résultats. required: false style: form explode: true schema: type: array items: type: string - name: limit in: query description: Le nombre maximum de résultats à afficher par page. required: false style: form explode: true schema: type: integer format: int32 - name: sort in: query description: Un tableau spécifiant l'ordre de tri des résultats. required: false style: form explode: true schema: type: array items: type: string responses: '200': description: successful operation content: application/json: schema: $ref: >- #/components/schemas/CollectionResponseWithTotalPublicChannelAccount default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - conversations.custom_channels.read - oauth2: - conversations.custom_channels.write components: schemas: CollectionResponseWithTotalPublicChannelAccount: required: - results - total type: object properties: paging: $ref: '#/components/schemas/Paging' results: type: array description: >- Un tableau d'objets PublicChannelAccount, chacun représentant un compte de canal public avec ses détails. items: $ref: '#/components/schemas/PublicChannelAccount' total: type: integer description: >- Un entier représentant le nombre total de comptes de canaux publics disponibles. format: int32 Paging: type: object properties: next: $ref: '#/components/schemas/NextPage' prev: $ref: '#/components/schemas/PreviousPage' description: >- Représente les informations de pagination pour naviguer dans une liste de résultats de l'API. Il fournit des détails sur la manière d'accéder à l'ensemble de résultats précédent ou suivant. PublicChannelAccount: required: - active - archived - authorized - channelId - createdAt - id - inboxId - name type: object properties: active: type: boolean description: Un booléen indiquant si le compte de canal est actuellement actif. archived: type: boolean description: Un booléen indiquant si le compte de canal est archivé. archivedAt: type: string description: >- La date et l'heure d'archivage du compte de canal, au format ISO 8601. format: date-time authorized: type: boolean description: Un booléen indiquant si le compte de canal est autorisé. channelId: type: string description: >- L'identifiant unique du canal auquel ce compte appartient, représenté sous forme de chaîne de caractères. createdAt: type: string description: >- La date et l'heure de création du compte de canal, au format ISO 8601. format: date-time deliveryIdentifier: $ref: '#/components/schemas/PublicDeliveryIdentifier' id: type: string description: >- L'identifiant unique de ce compte de canal, représenté sous forme de chaîne de caractères. inboxId: type: string description: >- L'identifiant unique de la boîte de réception associée à ce compte de canal, représenté sous forme de chaîne. name: type: string description: >- Le nom du compte de canal, représenté sous forme de chaîne de caractères. Error: required: - category - correlationId - message type: object properties: category: type: string description: La catégorie d'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreurs ou tickets d'assistance format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: informations supplémentaires à propos de l'erreur items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant de la documentation sur l'erreur ou les mesures correctives recommandées message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur 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 NextPage: required: - after type: object properties: after: type: string description: >- Un jeton de curseur de pagination pour récupérer les pages suivantes. link: type: string description: >- Une URL qui peut être utilisée pour récupérer les résultats de la page suivante. description: >- Specifies the paging information needed to retrieve the next set of results in a paginated API response PreviousPage: required: - before type: object properties: before: type: string description: >- Un jeton de chaîne indiquant la position avant la page actuelle dans la séquence de pagination. link: type: string description: >- Chaîne d'URL qui peut être utilisée pour accéder à la page de résultats précédente. description: >- specifies the paging information needed to retrieve the previous set of results in a paginated API response PublicDeliveryIdentifier: required: - type - value type: object properties: type: type: string description: "Une chaîne de caractères représentant le type d'identifiant de livraison. Les valeurs valides incluent «\_HS_EMAIL_ADDRESS\_», «\_HS_PHONE_NUMBER\_», «\_HS_SHORT_CODE\_» et «\_CHANNEL_SPECIFIC_OPAQUE_ID\_»." enum: - CHANNEL_SPECIFIC_OPAQUE_ID - HS_EMAIL_ADDRESS - HS_PHONE_NUMBER - HS_SHORT_CODE value: type: string description: >- Une chaîne représentant la valeur associée au type d'identifiant de livraison. ErrorDetail: required: - message type: object properties: code: type: string description: Le code du statut associé au détail de l'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: '{missingScopes=[scope1, scope2]}' in: type: string description: Le nom du champ ou du paramètre dans lequel l'erreur a été trouvée. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur 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: conversations.custom_channels.read: '' conversations.custom_channels.write: '' ````