Skip to main content
POST
Import contact
Use this endpoint when an integration needs to create or upsert one contact before enrichment, timeline download, or sequence assignment. The email field is a convenience alias for workEmail. If both are present, workEmail wins. String tags are normalized to { value }, while object tags may include iconName and color.

Authorizations

x-api-key
string
header
required

Primary public authentication method. Create keys in Jobin.cloud under Workgroups > Integrations > Custom integration.

Body

application/json
contact
object
required

Contact fields accepted by POST /contacts/import. Additional JSON properties are accepted and passed into the existing contact import path for supported Jobin contact fields.

notes
string[]
Maximum array length: 25
Required string length: 1 - 4096
autoUpdate
boolean

When true, the existing import path schedules automatic enrichment/update behavior for the contact.

overwriteMode
enum<string>
default:askBeforeOverwriting

Duplicate-handling mode used by the existing import service.

Available options:
overwriteWithNewest,
alwaysKeepOriginalOnOverwrite,
askBeforeOverwriting

Response

Imported contact identifier and import options applied by the backend.

contactId
string
autoUpdate
boolean
overwriteMode
enum<string>
Available options:
overwriteWithNewest,
alwaysKeepOriginalOnOverwrite,
askBeforeOverwriting