Reference / Imports

Start an import job. Returns the queued job; poll `GET /v1/imports/{id}` for progress.

POST /v1/imports

Secret API key operationId: create

Authorization

Server-to-server. Send a secret key as a Bearer token plus the x-application-id header.

Request body · required

dry_run boolean

Validate + count without writing (the writes are rolled back).
file string required

The raw export file contents (JSON or NDJSON, per the source).
source string required

One of `clerk | auth0 | firebase | supabase | cognito`.

Responses

201 Import queued

{
  "data": {
    "completed_at": "2026-01-15T09:30:00Z",
    "created_at": "2026-01-15T09:30:00Z",
    "dry_run": false,
    "error": "string",
    "errors": 0,
    "id": "018f3c4a-7b2e-7c1d-9e0a-1f2b3c4d5e6f",
    "imported": 0,
    "processed": 0,
    "skipped": 0,
    "source": "string",
    "status": "string",
    "summary": {},
    "total": 0,
    "without_password": 0
  },
  "error": {
    "code": "string",
    "message": "string"
  },
  "meta": {
    "timestamp": "string"
  },
  "success": false
}

422 Unknown source or unparseable export

Request

curl -X POST "https://api.identrahq.com/v1/imports" \
  -H "Content-Type: application/json" \
  -d '{
  "dry_run": false,
  "file": "string",
  "source": "clerk"
}'

Try it

live request

POST https://api.identrahq.com/v1/imports

Request body

application/json