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

# Import Integration

> Accept an integration export payload and process the import in the background.

Returns 202 immediately. The actual work (creating the integration, resource records,
and use cases with remapped IDs) runs as a background task. Check the server logs
for completion status and any non-fatal errors.



## OpenAPI

````yaml https://api-qa.interactly.ai/api-docs/integrations/api.json post /integrations/v2/integrations/import
openapi: 3.1.0
info:
  title: Interactly API
  description: API for building interactly.ai services
  version: 1.1.0
  contact:
    name: Interactly
    url: https://interactly.ai
    email: developers@interactly.ai
servers:
  - url: https://api-qa.interactly.ai
    description: API Server
security: []
paths:
  /integrations/v2/integrations/import:
    post:
      tags:
        - Integrations IO V2
      summary: Import Integration
      description: >-
        Accept an integration export payload and process the import in the
        background.


        Returns 202 immediately. The actual work (creating the integration,
        resource records,

        and use cases with remapped IDs) runs as a background task. Check the
        server logs

        for completion status and any non-fatal errors.
      operationId: integrations_service_import_integration_v2_integrations_import_post
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IntegrationImportBody'
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntegrationImportAcknowledged'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - bearer: []
components:
  schemas:
    IntegrationImportBody:
      properties:
        integration:
          $ref: '#/components/schemas/IntegrationImportItem'
        use_cases:
          items:
            $ref: '#/components/schemas/IntegrationImportItem'
          type: array
          title: Use Cases
        resource_records:
          items:
            $ref: '#/components/schemas/IntegrationImportItem'
          type: array
          title: Resource Records
      type: object
      title: IntegrationImportBody
      description: |-
        Request body for the import endpoint.

        Uses plain Pydantic models (not Beanie documents) so the body can be
        parsed without a live MongoDB connection.  The endpoint validates each
        item against the appropriate *BaseConfig* TypeAdapter after parsing.
    IntegrationImportAcknowledged:
      properties:
        message:
          type: string
          title: Message
          description: Human-readable status indicating the import has started.
      type: object
      required:
        - message
      title: IntegrationImportAcknowledged
      description: >-
        Immediate 202 acknowledgment returned when an import is accepted and
        queued for background processing.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    IntegrationImportItem:
      properties: {}
      additionalProperties: true
      type: object
      title: IntegrationImportItem
      description: >-
        Generic schema-less item used in import body parsing — accepts any
        fields.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: Bearer
      type: http
      description: >-
        Retrieve your API Key from [Dashboard API Keys
        Section](https://dashboard-qa.interactly.ai/api-keys).

````