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

# Import Target Accounts

> Add up to 1,000 target accounts in one call

Adds many companies to your target accounts at once. Send up to 1,000 rows per request (the
`queries.target_accounts.import_max_rows` setting); split a longer file into several requests.

**Each row is checked on its own.** Valid rows are added, invalid rows come back in `invalid`
with their row number and the reason, and one bad row never blocks the others. A row's number
is its `row`, else its position in `rows`, from 1.

* `name` needs at least 2 characters and must not be a URL. A bare domain like `Booking.com` is
  a name; `https://acme.com`, `www.acme.com` or a LinkedIn link is not: put a LinkedIn page in
  `linkedin_url`.
* `linkedin_url` is optional. When sent it must be a LinkedIn company page
  (`linkedin.com/company/acme`, or `/company/` and its numeric id), stored in its canonical form.

**Re-running an import is safe.** A row already on your list (the same LinkedIn page, else the
same name), or repeated within the request, is counted in `already_listed`.

**Tiers and tags are named, never created.** `tier` files the account under one of your tiers and
`tag` adds one of your account tags, both as your workspace spells them. A tag is applied to rows
already on the list too, once the row has matched a company. An unknown tier or tag fails the
whole request with `400`, so a typo never files every row somewhere nobody chose.

## Errors

| Status | Code | When |
| - | - | - |
| 400 | `BAD_REQUEST` | No rows, more than 1,000 rows, or a tier or tag your workspace does not have |

```bash cURL theme={null}
curl -X POST https://api.clustr-ai.com/v2/target_accounts/import \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rows": [
        {"row": 2, "name": "Acme Corp", "linkedin_url": "https://www.linkedin.com/company/acme-corp", "tier": "Tier 1"},
        {"row": 3, "name": "Globex"},
        {"row": 4, "name": "https://initech.com"}
      ]}'
```

```json 200 theme={null}
{
  "success": true,
  "data": {
    "added": 1,
    "already_listed": 1,
    "invalid": [
      { "row": 4, "reason": "Company name looks like a URL: put it in linkedin_url" }
    ]
  }
}
```

```json 400 theme={null}
{
  "success": false,
  "error": { "message": "Import at most 1000 rows per request", "code": "BAD_REQUEST" }
}
```


## OpenAPI

````yaml POST /v2/target_accounts/import
openapi: 3.1.0
info:
  title: Clustr API
  description: >
    Programmatic access to your Clustr network: import connectors, search warm
    intros, and manage target accounts.


    ## Authentication

    All endpoints require a Bearer token (API key) in the `Authorization`
    header.


    ```

    Authorization: Bearer <your_api_key>

    ```


    API keys can be created and managed from the [API settings
    page](https://app.clustr-ai.com/api).
  version: '2.0'
  contact:
    name: Clustr Support
    url: https://clustr-ai.com
servers:
  - url: https://api.clustr-ai.com
    description: Production
security:
  - BearerAuth: []
paths:
  /v2/target_accounts/import:
    post:
      tags:
        - Target Accounts
      summary: Import Target Accounts
      description: >
        Add up to 1,000 target accounts in one call (the
        `queries.target_accounts.import_max_rows`

        setting; more answers 400). Each row is checked on its own: a valid row
        is added, an invalid

        one is returned in `invalid` with its row number and reason and never
        imported, and the rest

        of the request still goes through.


        A row's `name` needs at least 2 characters and must not be a URL (a bare
        domain like

        `Booking.com` is a name). Its `linkedin_url` is optional; when sent it
        must be a LinkedIn

        company page, stored in its canonical form. A row already on your list
        (the same LinkedIn

        page, else the same name), or repeated in the request, is counted in
        `already_listed`.


        `tier` files the account under one of your tiers and `tag` adds one of
        your account tags,

        both by name. A tag is applied to rows already on the list too, once the
        row matches a

        company. An unknown tier or tag fails the whole request with 400:
        neither is ever created

        by an import.
      operationId: importTargetAccount
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - rows
              properties:
                rows:
                  type: array
                  minItems: 1
                  items:
                    type: object
                    properties:
                      row:
                        type: integer
                        description: >-
                          Your row number, echoed back if the row is invalid.
                          Defaults to its position in rows, from 1.
                      name:
                        type: string
                        description: The company's name.
                      linkedin_url:
                        type: string
                        description: >-
                          Optional. The company's LinkedIn company page, like
                          linkedin.com/company/acme.
                      tier:
                        type: string
                        description: Optional. A tier's name, as your workspace spells it.
                      tag:
                        type: string
                        description: >-
                          Optional. An account tag's name, as your workspace
                          spells it; several are separated by `;`.
      responses:
        '200':
          description: Envelope whose data is {added, already_listed, invalid}.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TargetAccountsImportedEnvelope'
              example:
                success: true
                data:
                  added: 12
                  already_listed: 3
                  invalid:
                    - row: 7
                      reason: Company name is required, at least 2 characters
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    TargetAccountsImportedEnvelope:
      example:
        success: true
        data:
          added: 3
          already_listed: 1
          invalid:
            - row: 4
              reason: 'Company name looks like a URL: put it in linkedin_url'
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
        data:
          allOf:
            - $ref: '#/components/schemas/TargetAccountImportResult'
    TargetAccountImportResult:
      type: object
      required:
        - added
        - already_listed
        - invalid
      properties:
        added:
          type: integer
        already_listed:
          type: integer
        invalid:
          type: array
          items:
            $ref: '#/components/schemas/TargetAccountInvalidRow'
    ErrorEnvelope:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          description: Always false.
        error:
          $ref: '#/components/schemas/ErrorInfo'
    TargetAccountInvalidRow:
      type: object
      required:
        - row
        - reason
      properties:
        row:
          type: integer
        reason:
          type: string
    ErrorInfo:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: >-
            What a client branches on, such as BAD_REQUEST or NOT_FOUND: one of
            the codes listed, the same on every operation. A code is added
            within a major version, never renamed.
          enum:
            - ADMIN_REQUIRED
            - ALREADY_LISTED
            - API_REQUEST_FAILED
            - ATTIO_NOT_CONNECTED
            - ATTIO_WORKSPACE_NOT_FOUND
            - AUTHORIZATION_UNAVAILABLE
            - AUTH_CONTEXT_ERROR
            - AUTH_FAILED
            - AUTH_METHOD_UNSUPPORTED
            - BAD_GATEWAY
            - BAD_REQUEST
            - BIGQUERY_ERROR
            - BODY_TOO_LARGE
            - BULK_PUSH_TOO_LARGE
            - BUYER_TITLES_UNAVAILABLE
            - CANCELLED
            - CANNOT_CHANGE_OWN_ROLE
            - CANNOT_DEACTIVATE_SELF
            - CANNOT_REMOVE_SELF
            - CLEANING_REPORT_FAILED
            - CLEANING_REPORT_UNAVAILABLE
            - CLIENT_CLOSED_REQUEST
            - COMPANY_NOT_FOUND
            - COMPANY_NOT_RESOLVED
            - COMPETITOR_EXISTS
            - COMPETITOR_READ_FAILED
            - COMPETITOR_RUN_FAILED
            - CONFLICT
            - CRM_CAPABILITY_UNSUPPORTED
            - CRM_CREDENTIAL_EXPIRED
            - CRM_DAILY_LIMIT
            - CRM_LISTS_UNSUPPORTED
            - CRM_NOT_ACTIVE
            - CRM_NOT_CONNECTED
            - CRM_RATE_LIMITED
            - CRM_RECONNECT_REQUIRED
            - CRM_ROW
            - CRM_SCHEMA_UNAVAILABLE
            - CRM_SCOPE_MISSING
            - CRM_UNAVAILABLE
            - CRM_VALUES_UNAVAILABLE
            - CRM_WRITE_DISABLED
            - CUSTOMERS_UNAVAILABLE
            - DATABASE_NOT_FOUND
            - DATASET_NOT_FOUND
            - DUPLICATE_ALREADY_RESOLVED
            - DUPLICATE_CHECK_FAILED
            - EMAIL_NOTIFIER_UNAVAILABLE
            - ENTITLEMENT_UNAVAILABLE
            - ESCALATION_EMAIL_DISABLED
            - EXPORT_FAILED
            - EXPORT_IN_FLIGHT
            - EXPORT_UNAVAILABLE
            - FAMILY_CLUSTER
            - FEATURE_NOT_ENABLED
            - FINDING_NOT_APPLICABLE
            - FIRE_FAILED
            - FORBIDDEN
            - FULLENRICH_API_ERROR
            - FULLENRICH_UNEXPECTED_ERROR
            - GATEWAY_TIMEOUT
            - HEADERS_TOO_LARGE
            - HUBSPOT_NOT_CONNECTED
            - HUBSPOT_UPSTREAM_ERROR
            - INSUFFICIENT_CREDITS
            - INSUFFICIENT_PERMISSION
            - INTEGRATION_REAUTH_REQUIRED
            - INTERNAL_ERROR
            - INVALID_BODY
            - INVALID_BOOLEAN
            - INVALID_BUCKET
            - INVALID_COMPANY_NAME
            - INVALID_CREDENTIALS
            - INVALID_CUSTOMER_RULE
            - INVALID_ENDPOINT
            - INVALID_EVENT
            - INVALID_FIELD
            - INVALID_INPUT
            - INVALID_LINKEDIN_URL
            - INVALID_MAPPING
            - INVALID_MATCHING_SETTINGS
            - INVALID_OBJECT_TYPE
            - INVALID_REQUEST
            - INVALID_SCHEDULE
            - INVALID_SETTINGS
            - INVALID_SIGNATURE
            - INVALID_TARGET_LIST
            - INVALID_TENANT_ID
            - INVALID_TOKEN
            - INVALID_URL
            - INVALID_UUID
            - INVALID_WEBSITE_URL
            - JOB_CLIENT_NOT_CONFIGURED
            - JOB_CREATION_FAILED
            - JOB_NOT_FOUND
            - KEY_NOT_REGISTERED
            - LAST_ADMIN
            - LOAD_FAILED
            - MAPPING_NOT_FOUND
            - MATCHING_SETTINGS_CONFLICT
            - MATCHING_VERSION_NOT_FOUND
            - MERGES_DISABLED
            - MERGE_UNRESOLVED
            - MERGE_UNSUPPORTED
            - METHOD_NOT_ALLOWED
            - MISSING_FIELDS
            - MISSING_HEADER
            - MISSING_JOB_ID
            - MISSING_OBJECT_ID
            - MISSING_PORTAL_ID
            - MISSING_TENANT_ID
            - MISSING_USER_ID
            - NOT_APPLIED
            - NOT_AUTO_SAFE
            - NOT_CONFIGURED
            - NOT_CONNECTED
            - NOT_DUPLICATE_CLUSTER
            - NOT_ENABLED
            - NOT_FOUND
            - NOT_RETRYABLE
            - NOT_REVERTABLE
            - NO_ACTIVE_WAREHOUSE
            - NO_BUYER_TITLES
            - NO_CONNECTION
            - NO_LINKEDIN_URL
            - NO_MATCH_KEY
            - NO_ORG
            - NO_PACKAGE
            - NO_SLOT
            - NO_TEAM_FOUND
            - NO_TOKEN
            - NO_WEBSITE
            - ORG_LIMIT_EXCEEDED
            - PANIC_RECOVERED
            - PARSE_ERROR
            - PAYLOAD_TOO_LARGE
            - PAYMENT_REQUIRED
            - PERSON_LEFT
            - PORTAL_TENANT_MISMATCH
            - PRIVATE_CHANNEL_NEEDS_INVITE
            - PROCESSING_ERROR
            - PROFILE_NOT_RESOLVED
            - PROJECT_NOT_FOUND
            - PROPERTY_INSIGHTS_FAILED
            - PROPERTY_INSIGHTS_UNAVAILABLE
            - QUEUE_UNAVAILABLE
            - RATE_LIMITED
            - RATE_LIMITER_INIT_FAILED
            - RATE_LIMIT_EXCEEDED
            - REDIRECT_REFUSED
            - REFRESH_RATE_LIMITED
            - REFRESH_UNAVAILABLE
            - REPORT_ONLY_DUPLICATE
            - REQUEST_FAILED
            - RESEARCH_NOT_STARTED
            - RESOURCE_EXHAUSTED
            - RESPONSE_READ_FAILED
            - REVERT_BATCH_UNAVAILABLE
            - REVERT_CONFLICT
            - REVERT_EXPIRED
            - ROUTE_NOT_FOUND
            - SALESFORCE_NOT_CONNECTED
            - SALESFORCE_ORG_NOT_FOUND
            - SAVE_FAILED
            - SEARCH_FAILED
            - SERVICE_NOT_FOUND
            - SERVICE_UNAVAILABLE
            - SERVICE_UNREACHABLE
            - SETUP_FAILED
            - SETUP_RATE_LIMITED
            - SLACK_REJECTED
            - SNOWFLAKE_ERROR
            - STAFF_REQUIRED
            - SUPABASE_NEEDS_POOLER
            - SYNC_IN_PROGRESS
            - SYNC_PROPERTIES_DISABLED
            - SYNC_STATUS_UNAVAILABLE
            - SYNC_UNAVAILABLE
            - TABLE_SHAPE_MISMATCH
            - TARGET_ACCOUNTS_UNAVAILABLE
            - TARGET_LIST_NOT_BINDABLE
            - TARGET_LIST_NOT_FOUND
            - TASK_CREATION_FAILED
            - TENANT_LOOKUP_FAILED
            - TENANT_MISMATCH
            - TOO_MANY_HEADERS
            - TOO_SOON
            - UNAUTHORIZED
            - UNAVAILABLE
            - UNKNOWN_ERROR
            - UNKNOWN_FEATURE
            - UNKNOWN_PORTAL
            - UNKNOWN_PROVIDER
            - UNPROCESSABLE_ENTITY
            - UNSUPPORTED_FLOW
            - UNSUPPORTED_MEDIA_TYPE
            - UNSUPPORTED_OBJECT_TYPE
            - UNSUPPORTED_PROVIDER
            - UNSUPPORTED_RESOURCE_TYPE
            - UPSTREAM_ERROR
            - UPSTREAM_UNAVAILABLE
            - URL_TOO_LONG
            - USER_NOT_AUTHORIZED
            - VALIDATION_ERROR
            - VALUES_FAILED
            - VALUES_UNAVAILABLE
            - VERIFICATION_UNAVAILABLE
            - WEBHOOK_UNAVAILABLE
        message:
          type: string
          description: The sentence a person reads.
        details:
          type: string
          description: Developer text, returned outside production only.
        request_id:
          type: string
          description: >-
            The request's id, for support. Always set, and the same as the
            X-Request-ID response header.
  responses:
    BadRequest:
      description: Request validation failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Unauthorized:
      description: Missing or invalid auth.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    Forbidden:
      description: Authenticated caller is not permitted for this resource.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
    InternalServerError:
      description: Unexpected server-side failure.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: The API key you created on the API settings page of the Clustr app.

````

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