Import

POST

/contacts/import

const url = 'https://example.com/contacts/import';
const options = {
  method: 'POST',
  headers: {'Idempotency-Key': '2489E9AD-2EE2-8E00-8EC9-32D5F69181C0'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://example.com/contacts/import \
  --header 'Idempotency-Key: 2489E9AD-2EE2-8E00-8EC9-32D5F69181C0'

Who can call it: Owners and Staff. Staff need the Team right Create/edit own contacts (contacts.edit_own).

curl -X POST "https://spine.example.com/api/contacts/import" \
  -H "Cookie: better-auth.session_token=<session>" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" -d '{ … }'

Parameters

Header Parameters

Idempotency-Key

required

string format: uuid

A fresh UUID per action. A retry with the same key gets the first answer instead of doing it twice.

Responses

201

400

Validation failed or a business rule was broken; message says what to change.

401

No session, or it has expired: sign in again.

403

The caller’s role, Team rights or ownership don’t allow it, the module is switched off, or their access was removed.

404

No such record in this business.

409

The same Idempotency-Key is still being handled, or the record conflicts with one that exists.

429

Too many requests: wait a minute.

500

Something went wrong on the server; the response carries the request id to report.