API Reference
Getting Started
Core Concepts
Backend API — Guides
Frontend API — Guides
OAuth & OpenID Connect — Guides
Enterprise: SSO & SCIM — Guides
Webhooks — Guides
SDKs
Backend API (BAPI)
Frontend API (FAPI)
Dashboard API
Public API
SCIM
OIDC
Platform

User Imports

AdminUpdated Sep 11, 2026

User Imports

Backend API — secret key (Authorization: Bearer sk_…).

1 route. Each row is one endpoint with its explanation, required scope, and whether it honours the Idempotency-Key header.

Method & path

Scope

Idem

Explanation

POST /v1/user_imports

jobs:write

✓

Bulk-create users from an array, deduping by verified email, through the same path sign-up uses. Plaintext passwords are Argon2id-hashed; an Argon2id hash is imported verbatim; other hash formats are rejected per row. Per-row failures are recorded, never fatal.

Was this page helpful?