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

# import_integration

> **Import integration**

Start an initial data import for an authenticated provider, or retry a failed initial import with its saved configuration. Use the exact source, account id, and ETL id returned by get_integration_state.

Confirm the requested history and optional field choices before starting. Repeating start on an importing or ready connection reports its current state instead of restarting it or expanding its history. Use retry only after a failed import; it preserves the original selection and does not accept history_days, selected_fields, or selected_objects. Workspace import limits still apply. Slack imports and retries require the bot to be in at least one selected channel; if none are available, ask the user to add Rippit to a channel before trying again.

Salesforce start requires selected_objects from get_integration_state query.kind objects, not selected_fields. Confirm the objects and history with the user. Case is the conversation table; other objects create separate tables. Objects marked doFullRepull import all history even when history_days is smaller. Retry preserves the saved objects and Case choice. If status.warning says retry is unavailable, report it instead of retrying.

This call starts work and returns; get_integration_state reports progress and the resulting table.



## OpenAPI

````yaml /api-reference/tools-openapi.json post /v1/import_integration
openapi: 3.1.0
info:
  title: Rippit API
  version: 1.0.0
  description: Every operation is also an MCP tool with the same name and parameters.
servers:
  - url: https://api.rippit.com
security:
  - bearer: []
paths:
  /v1/import_integration:
    post:
      summary: import_integration
      description: >-
        **Import integration**


        Start an initial data import for an authenticated provider, or retry a
        failed initial import with its saved configuration. Use the exact
        source, account id, and ETL id returned by get_integration_state.


        Confirm the requested history and optional field choices before
        starting. Repeating start on an importing or ready connection reports
        its current state instead of restarting it or expanding its history. Use
        retry only after a failed import; it preserves the original selection
        and does not accept history_days, selected_fields, or selected_objects.
        Workspace import limits still apply. Slack imports and retries require
        the bot to be in at least one selected channel; if none are available,
        ask the user to add Rippit to a channel before trying again.


        Salesforce start requires selected_objects from get_integration_state
        query.kind objects, not selected_fields. Confirm the objects and history
        with the user. Case is the conversation table; other objects create
        separate tables. Objects marked doFullRepull import all history even
        when history_days is smaller. Retry preserves the saved objects and Case
        choice. If status.warning says retry is unavailable, report it instead
        of retrying.


        This call starts work and returns; get_integration_state reports
        progress and the resulting table.
      operationId: import_integration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                source:
                  type: string
                  enum:
                    - zendesk
                    - intercom
                    - slack_ingest
                    - gong
                    - salesforce
                  description: Provider returned by get_integration_state.
                account_id:
                  type: string
                  minLength: 1
                  maxLength: 255
                  description: Exact provider account id returned by get_integration_state.
                etl_id:
                  type: integer
                  exclusiveMinimum: 0
                  maximum: 9007199254740991
                  description: ETL id of that same connection.
                action:
                  type: string
                  enum:
                    - start
                    - retry
                  description: Start the initial import or retry a failed initial import.
                history_days:
                  description: >-
                    Required for start: days of history counted back from today.
                    Confirm an ambiguous period. Forbidden for retry, which
                    preserves the existing import configuration.
                  type: integer
                  minimum: 0
                  maximum: 104249991374
                selected_objects:
                  description: >-
                    Required for Salesforce start: exact object names returned
                    by get_integration_state query.kind objects. Confirm any
                    doFullRepull objects import all history. Forbidden for other
                    providers and retry.
                  minItems: 1
                  type: array
                  items:
                    type: string
                    minLength: 1
                    maxLength: 255
                selected_fields:
                  description: >-
                    Nonempty fields[].rawFieldName values returned by
                    get_integration_state, not fieldName display labels. Omit to
                    use provider defaults.
                  minItems: 1
                  maxItems: 150
                  type: array
                  items:
                    type: string
                    maxLength: 255
              required:
                - source
                - account_id
                - etl_id
                - action
              additionalProperties: false
      responses:
        '200':
          description: Tool result.
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.