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

# Get Integration Config

> Retrieves integration configuration details by ID

Retrieves detailed integration configuration information by integration ID. This endpoint returns comprehensive details about the configuration, including associated card information, available email accounts, and merge tag definitions.

## Query Parameters

<ParamField query="integrationId" type="string" required>
  The integration configuration ID returned when you created the configuration
</ParamField>

## Response Details

Returns an array with detailed configuration information:

<ResponseField name="key" type="string">
  Always "items" to identify the response type
</ResponseField>

<ResponseField name="cardId" type="string">
  ID of the card associated with this configuration
</ResponseField>

<ResponseField name="emailAccount" type="array">
  Available email accounts for this configuration

  <Expandable title="Email account structure">
    <ResponseField name="id" type="string">
      Email account identifier
    </ResponseField>

    <ResponseField name="fromEmail" type="string">
      Email address (e.g., "[hello@company.com](mailto:hello@company.com)")
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="mergeTags" type="array">
  Merge tag fields available for this card

  <Expandable title="Merge tag structure">
    <ResponseField name="tagName" type="string">
      Name of the merge tag field (e.g., "name", "email", "company")
    </ResponseField>

    <ResponseField name="type" type="string">
      Data type of the merge tag (e.g., "text", "email")
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="card" type="object">
  Information about the associated card

  <Expandable title="Card information">
    <ResponseField name="cardId" type="string">
      Card identifier
    </ResponseField>

    <ResponseField name="title" type="string">
      Card name/title, or "untitled" if no title is set
    </ResponseField>
  </Expandable>
</ResponseField>

## Response Example

```json theme={null}
[
  {
    "key": "items",
    "cardId": "60f7b2b5b8f4a20015a4f5a5",
    "emailAccount": [
      {
        "id": "60f7b2b5b8f4a20015a4f5a6",
        "fromEmail": "hello@company.com"
      },
      {
        "id": "60f7b2b5b8f4a20015a4f5a7", 
        "fromEmail": "support@company.com"
      }
    ],
    "mergeTags": [
      {
        "tagName": "name",
        "type": "text"
      },
      {
        "tagName": "email",
        "type": "email"
      },
      {
        "tagName": "company",
        "type": "text"
      }
    ],
    "card": {
      "cardId": "60f7b2b5b8f4a20015a4f5a5",
      "title": "Welcome Card"
    }
  }
]
```


## OpenAPI

````yaml GET /integration/config
openapi: 3.1.0
info:
  title: CardClan Integration API
  description: >-
    The CardClan Integration API enables third-party applications and automation
    platforms to send personalized digital cards, manage workflows, and
    integrate CardClan's functionality into existing systems.
  version: 1.0.0
  license:
    name: MIT
servers:
  - url: https://app.cardclan.io/api
security:
  - bearerAuth: []
paths:
  /integration/config:
    get:
      tags:
        - Configuration
      summary: Get Integration Configuration
      description: Retrieves integration configuration details by ID
      parameters:
        - name: integrationId
          in: query
          required: true
          description: Integration configuration ID
          schema:
            type: string
      responses:
        '200':
          description: Integration configuration retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConfigResponse'
        '400':
          description: Error fetching configuration
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    ConfigResponse:
      type: array
      items:
        type: object
        properties:
          key:
            type: string
            example: items
          cardId:
            type: string
            example: 60f7b2b5b8f4a20015a4f5a5
          emailAccount:
            type: array
            items:
              $ref: '#/components/schemas/EmailAccount'
          mergeTags:
            type: array
            items:
              $ref: '#/components/schemas/MergeTagDefinition'
          card:
            type: object
            properties:
              cardId:
                type: string
                example: 60f7b2b5b8f4a20015a4f5a5
              title:
                type: string
                example: Welcome Card
    Error:
      type: object
      properties:
        error:
          type: string
          example: Bad Request
        message:
          type: string
          example: Card ID is required
        statusCode:
          type: number
          example: 400
        timestamp:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00.000Z'
    EmailAccount:
      type: object
      properties:
        key:
          type: string
          example: 60f7b2b5b8f4a20015a4f5a6
        value:
          type: string
          example: hello@company.com
        label:
          type: string
          example: Email account
        id:
          type: string
          example: 60f7b2b5b8f4a20015a4f5a6
        name:
          type: string
          example: hello@company.com
    MergeTagDefinition:
      type: object
      properties:
        tagName:
          type: string
          example: name
        type:
          type: string
          example: text
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Enter your CardClan integration key

````