> ## 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 a channel account by id > Récupérez les détails d'un compte de chaîne spécifique. Cela comprend toutes les métadonnées relatives à votre compte de chaîne, y compris sa chaîne, l'identifiant de la boîte de réception associée et les informations d'identification de livraison. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-03/conversations-custom-channels-v2026-03.json GET /conversations/custom-channels/2026-03/{channelId}/channel-accounts/{channelAccountId} 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/{channelAccountId}: get: tags: - Channels summary: Obtenir un compte de canal par ID description: >- Récupérez les détails d'un compte de chaîne spécifique. Cela comprend toutes les métadonnées relatives à votre compte de chaîne, y compris sa chaîne, l'identifiant de la boîte de réception associée et les informations d'identification de livraison. operationId: >- get-/conversations/custom-channels/2026-03/{channelId}/channel-accounts/{channelAccountId} parameters: - name: channelAccountId in: path description: L'identifiant unique du compte de canal à récupérer. required: true style: simple explode: false schema: type: integer format: int64 - name: channelId in: path description: L'identifiant unique du canal personnalisé. required: true style: simple explode: false schema: type: integer format: int32 - 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 default: false responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/PublicChannelAccount' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - conversations.custom_channels.read - oauth2: - conversations.custom_channels.write components: schemas: 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. 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. 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 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: '' ````