Create import

POST 
/v1/imports

Uploads a CSV file of customers or charges and queues asynchronous processing. The body is JSON with the raw CSV text in the content field (max 2 MB). Invalid rows do not abort the batch: they are recorded in errors ([{ line, error }]) while the rest is processed. Track progress via GET /imports/{id}. Responds 202. Requires the import access level (or all) — write is not enough.

Request

Responses

202

Import accepted and queued for processing.

400

Invalid request (validation error).

401

Missing, invalid, expired or revoked token.

403

The token lacks the scope required by this operation.

404

Resource not found or outside your organization.

413

File larger than 2 MB — split the file into smaller parts.

429

Rate limit exceeded (600 per minute per key; 60 invalid attempts per minute per IP). Wait for Retry-After.

500

Internal error. Retry; if it persists, contact support.