curl -X POST "https://app.emailx.ai/api/v1/workspaces/123/contacts/imports" \
  -H "Authorization: Bearer $EMAILX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: example-operation-001" \
  --data '{"file_base64":"RW1haWwKYWRhQGV4YW1wbGUudGVzdAo=","filename":"contacts.csv","mapping":{"email":"Email"},"channel":"email","expected_fingerprint":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","confirm_import":true}'

import os, requests

response = requests.post(
    "https://app.emailx.ai/api/v1/workspaces/123/contacts/imports",
    headers={"Authorization": "Bearer " + os.environ["EMAILX_API_KEY"], "Idempotency-Key": "example-operation-001"},
    json={'file_base64': 'RW1haWwKYWRhQGV4YW1wbGUudGVzdAo=', 'filename': 'contacts.csv', 'mapping': {'email': 'Email'}, 'channel': 'email', 'expected_fingerprint': 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa', 'confirm_import': True},
    timeout=30,
)
response.raise_for_status()
print(response.json())

const response = await fetch("https://app.emailx.ai/api/v1/workspaces/123/contacts/imports", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.EMAILX_API_KEY}`, "Content-Type": "application/json", "Idempotency-Key": "example-operation-001" },
  body: JSON.stringify({"file_base64": "RW1haWwKYWRhQGV4YW1wbGUudGVzdAo=", "filename": "contacts.csv", "mapping": {"email": "Email"}, "channel": "email", "expected_fingerprint": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "confirm_import": true}),
  signal: AbortSignal.timeout(30000),
});
if (!response.ok) throw new Error(`Emailx: ${response.status}`);
console.log(await response.json());

{
  "data": {
    "id": "op_0123456789abcdef0123456789abcdef",
    "workspace_id": 123,
    "kind": "people.import",
    "resource_type": "workspace",
    "resource_id": 123,
    "status": "queued",
    "created_at": "2026-11-01T09:00:00Z",
    "updated_at": "2026-11-01T09:00:00Z",
    "completed_at": null,
    "error_code": null,
    "cancellable": true
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "request_id": "<string>",
    "details": {}
  }
}