---
title: "Create Public Import Job Compat"
method: POST
path: "/v2/public/imports"
tags: ["imports"]
---

# Create Public Import Job Compat

`POST /v2/public/imports`

## Query parameters

- `workspace_id` string, nullable

## Headers

- `X-Workspace-Code` string

## Request body

- ImportJobCreateRequest
  - `object_type` string, required
  - `source_kind` string
  - `file_format` string
  - `file_id` string, nullable
  - `custom_object_id` string, nullable
  - `provider` string, nullable
  - `channel_id` string, nullable
  - `mapping_template_id` string, nullable
  - `mapping_template_revision` integer, nullable
  - `mapping_template_state` object, nullable
  - `record_ids` string[], nullable
  - `source_record` object, nullable — Provider-specific source metadata. For Stripe invoice/subscription backfills, use scope=all with optional days_ago, created_gte, and limit; bounded synchronous backfills support up to 200 records.
  - `operation` string
  - `mapping_mode` string
  - `key_field` string, nullable
  - `relation_key_map` object
  - `column_mappings` TransferColumnMapping[]
    - `source_header` string, required
    - `target_field` string, required
  - `dry_run` boolean
  - `idempotency_key` string, nullable
  - `workflow_action_tracker_id` string, nullable
  - `action_tracker_id` string, nullable
  - `workflow_language` string, nullable

## Response `200`

Successful Response

- CreatePublicImportJobCompatApiV2PublicImportsPost200Envelope
  - `success` true, required
  - `data` object, required
  - `meta` EnvelopeMeta, required
    - `ctx_id` string, required
    - `pagination` PaginationMeta
      - `page` integer, required
      - `page_size` integer, required
      - `total` integer, required
      - `next_cursor` string, nullable
    - `toast` ToastMessage
      - `variant` 'success' | 'error' | 'info' | 'warning', required
      - `code` string, required
      - `message` string, required
      - `i18n` ToastMessageI18n, required
        - `en` string, required
        - `ja` string, required

## Other responses

- `401` — Error response
- `422` — Error response

---

[API](https://skmtc.net/sankahq/apis/sanka-public-api.md) · [All operations](https://skmtc.net/sankahq/apis/sanka-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankahq/sanka-public-api/revisions/91dba803a2c1/schema)