Skip to main content
POST
Import contact
Save a contact in Jobin before enriching their profile or adding them to a sequence. Choose overwriteMode to control how matching records are updated, and autoUpdate for automatic profile updates. You can use email for a work email address. If you send both email and workEmail, Jobin uses workEmail. Supply tags as names or as objects with a value. Tag objects can also include iconName and color. Import profile details only. Internal ownership, workflow, pipeline membership, sequence state, derived flags, and unknown fields are rejected. Use the dedicated pipeline, campaign and document endpoints for those actions. A supplied contact _id can replay an existing contact only within the authenticated workgroup. Rate limit: 30 requests/minute per endpoint and workgroup. Details.

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

Trimmed, nonempty note.

Required string length: 1 - 4000
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 the import options used.

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