> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.zenskar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get customer connector details

> Retrieve connector integration details for a specific customer by connector name.

Returns connector-specific information including:
- Reference ID in the external system
- Customer name
- Customer email

Requirements:
- Customer must belong to the authenticated organization
- Valid UUID format required for customer_id
- Valid connector name required (e.g., 'stripe', 'avalara', 'quickbooks', 'salesforce', 'xero', 'hubspot', 'zoho', 'adyen', 'anrok', 'dealhub', 'netsuite')

Possible errors:
- 404: Customer not found
- 400: No integration found for the specified connector
- 400: Integration no longer available (resource deleted on connector)
- 400: General processing error
- 422: Invalid UUID format



## OpenAPI

````yaml /openAPI/openapi-20240301.json get /customers/{customer_id}/connector/{connector_name}
openapi: 3.1.0
info:
  title: zenskar
  version: 2.0.0
servers:
  - url: https://api.zenskar.com
security:
  - ApiTokenAuth: []
    OrganisationAuth: []
paths:
  /customers/{customer_id}/connector/{connector_name}:
    get:
      tags:
        - Customers
      summary: Get customer connector details
      description: >-
        Retrieve connector integration details for a specific customer by
        connector name.


        Returns connector-specific information including:

        - Reference ID in the external system

        - Customer name

        - Customer email


        Requirements:

        - Customer must belong to the authenticated organization

        - Valid UUID format required for customer_id

        - Valid connector name required (e.g., 'stripe', 'avalara',
        'quickbooks', 'salesforce', 'xero', 'hubspot', 'zoho', 'adyen', 'anrok',
        'dealhub', 'netsuite')


        Possible errors:

        - 404: Customer not found

        - 400: No integration found for the specified connector

        - 400: Integration no longer available (resource deleted on connector)

        - 400: General processing error

        - 422: Invalid UUID format
      operationId: Get-customer-connector-details
      parameters:
        - name: customer_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Customer Id
        - name: connector_name
          in: path
          required: true
          schema:
            type: string
            title: Connector Name
      responses:
        '200':
          description: Successfully retrieved customer connector details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerConnectorResponseSchema'
              example:
                connector_name: stripe
                reference_id: cus_12345
                customer_name: Acme Corporation
                email: billing@acme.com
        '400':
          description: Bad request - connector or integration issues
          content:
            application/json:
              examples:
                no_integration:
                  summary: No integration found
                  value:
                    error_code: BAD_REQUEST
                    message: No integration found for connector 'stripe'.
                integration_unavailable:
                  summary: Integration unavailable
                  value:
                    error_code: BAD_REQUEST
                    message: The requested integration is no longer available.
                general_error:
                  summary: General processing error
                  value:
                    error_code: BAD_REQUEST
                    message: An error occurred while processing your request.
        '404':
          description: Customer not found
          content:
            application/json:
              example:
                error_code: NOT_FOUND
                message: Customer not found
        '422':
          description: Unprocessable Entity - invalid UUID
          content:
            application/json:
              example:
                status_code: 10422
                message: >-
                  1 validation error for Path; customer_id: value is not a valid
                  uuid
        '500':
          description: Internal server error
          content:
            application/json:
              example:
                error_code: INTERNAL_SERVER_ERROR
                message: Failed to retrieve customer connector details
components:
  schemas:
    CustomerConnectorResponseSchema:
      properties:
        connector_name:
          type: string
          title: Connector Name
          description: Name of the connector
        reference_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Reference Id
          description: External reference ID in the connector system
        customer_name:
          type: string
          title: Customer Name
          description: Name of the customer
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
          description: Email address of the customer
      type: object
      required:
        - connector_name
        - customer_name
      title: CustomerConnectorResponseSchema
      description: |-
        Schema for customer connector details response

        This schema represents the response structure for the customer connector
        details endpoint. It includes basic information about a customer's
        integration with an external connector system.
  securitySchemes:
    ApiTokenAuth:
      type: apiKey
      in: header
      name: x-api-key
      x-default: <your-api-key>
    OrganisationAuth:
      type: apiKey
      in: header
      name: organisation
      x-default: <your-organisation-id>

````