opensesh docsBulk import contacts
Idempotent by email. behavior: "update" refreshes existing contacts, "skip" leaves them untouched. Returns created/updated/skipped counts with a per-row outcome list.
Authorization
bearerAuth AuthorizationBearer <token>
An organization API key (osk_…)
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/contacts/import" \ -H "Content-Type: application/json" \ -d '{ "behavior": "update", "rows": [ { "firstName": "string", "lastName": "string", "email": "string", "title": "string", "company": "string", "bio": "string" } ] }'{ "created": 0, "updated": 0, "skipped": 0, "outcomes": [ { "email": "string", "action": "created" } ]}