Bulk import contacts
curl --request POST \
--url https://my.jobin.cloud/api/openapi/v1/contacts/import/bulk \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"contacts": [
{
"contact": {
"_id": "<string>",
"firstName": "<string>",
"middleName": "<string>",
"lastName": "<string>",
"socialUrl": "<string>",
"email": "[email protected]",
"workEmail": "[email protected]",
"privateEmail": "[email protected]",
"otherEmails": [
"[email protected]"
],
"workPhone": "<string>",
"privatePhone": "<string>",
"otherPhones": [
"<string>"
],
"workMobilePhone": "<string>",
"privateMobilePhone": "<string>",
"otherMobilePhones": [
"<string>"
],
"summary": "<string>",
"tags": [
"<string>"
],
"customFieldList": [
{
"fieldName": "<string>",
"_id": "<string>",
"value": "<string>",
"customFieldDefinitionId": "<string>",
"textValue": "<string>",
"numberValue": 123,
"dateValue": "2023-11-07T05:31:56Z",
"listValue": "<string>"
}
]
},
"notes": [
"<string>"
],
"autoUpdate": true,
"overwriteMode": "askBeforeOverwriting"
}
]
}
'const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
contacts: [
{
contact: {
_id: '<string>',
firstName: '<string>',
middleName: '<string>',
lastName: '<string>',
socialUrl: '<string>',
email: '[email protected]',
workEmail: '[email protected]',
privateEmail: '[email protected]',
otherEmails: ['[email protected]'],
workPhone: '<string>',
privatePhone: '<string>',
otherPhones: ['<string>'],
workMobilePhone: '<string>',
privateMobilePhone: '<string>',
otherMobilePhones: ['<string>'],
summary: '<string>',
tags: ['<string>'],
customFieldList: [
{
fieldName: '<string>',
_id: '<string>',
value: '<string>',
customFieldDefinitionId: '<string>',
textValue: '<string>',
numberValue: 123,
dateValue: '2023-11-07T05:31:56Z',
listValue: '<string>'
}
]
},
notes: ['<string>'],
autoUpdate: true,
overwriteMode: 'askBeforeOverwriting'
}
]
})
};
fetch('https://my.jobin.cloud/api/openapi/v1/contacts/import/bulk', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://my.jobin.cloud/api/openapi/v1/contacts/import/bulk"
payload = { "contacts": [
{
"contact": {
"_id": "<string>",
"firstName": "<string>",
"middleName": "<string>",
"lastName": "<string>",
"socialUrl": "<string>",
"email": "[email protected]",
"workEmail": "[email protected]",
"privateEmail": "[email protected]",
"otherEmails": ["[email protected]"],
"workPhone": "<string>",
"privatePhone": "<string>",
"otherPhones": ["<string>"],
"workMobilePhone": "<string>",
"privateMobilePhone": "<string>",
"otherMobilePhones": ["<string>"],
"summary": "<string>",
"tags": ["<string>"],
"customFieldList": [
{
"fieldName": "<string>",
"_id": "<string>",
"value": "<string>",
"customFieldDefinitionId": "<string>",
"textValue": "<string>",
"numberValue": 123,
"dateValue": "2023-11-07T05:31:56Z",
"listValue": "<string>"
}
]
},
"notes": ["<string>"],
"autoUpdate": True,
"overwriteMode": "askBeforeOverwriting"
}
] }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)$headers=@{}
$headers.Add("x-api-key", "<api-key>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://my.jobin.cloud/api/openapi/v1/contacts/import/bulk' -Method POST -Headers $headers -ContentType 'application/json' -Body '{
"contacts": [
{
"contact": {
"_id": "<string>",
"firstName": "<string>",
"middleName": "<string>",
"lastName": "<string>",
"socialUrl": "<string>",
"email": "[email protected]",
"workEmail": "[email protected]",
"privateEmail": "[email protected]",
"otherEmails": [
"[email protected]"
],
"workPhone": "<string>",
"privatePhone": "<string>",
"otherPhones": [
"<string>"
],
"workMobilePhone": "<string>",
"privateMobilePhone": "<string>",
"otherMobilePhones": [
"<string>"
],
"summary": "<string>",
"tags": [
"<string>"
],
"customFieldList": [
{
"fieldName": "<string>",
"_id": "<string>",
"value": "<string>",
"customFieldDefinitionId": "<string>",
"textValue": "<string>",
"numberValue": 123,
"dateValue": "2023-11-07T05:31:56Z",
"listValue": "<string>"
}
]
},
"notes": [
"<string>"
],
"autoUpdate": true,
"overwriteMode": "askBeforeOverwriting"
}
]
}'{
"items": [
{
"contactId": "<string>",
"autoUpdate": true,
"overwriteMode": "overwriteWithNewest"
}
],
"count": 123
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "<string>",
"retryAfterSeconds": 123
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}Contacts
Import contacts in bulk
Import up to 50 contacts and review the result for each person.
POST
/
contacts
/
import
/
bulk
Bulk import contacts
curl --request POST \
--url https://my.jobin.cloud/api/openapi/v1/contacts/import/bulk \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"contacts": [
{
"contact": {
"_id": "<string>",
"firstName": "<string>",
"middleName": "<string>",
"lastName": "<string>",
"socialUrl": "<string>",
"email": "[email protected]",
"workEmail": "[email protected]",
"privateEmail": "[email protected]",
"otherEmails": [
"[email protected]"
],
"workPhone": "<string>",
"privatePhone": "<string>",
"otherPhones": [
"<string>"
],
"workMobilePhone": "<string>",
"privateMobilePhone": "<string>",
"otherMobilePhones": [
"<string>"
],
"summary": "<string>",
"tags": [
"<string>"
],
"customFieldList": [
{
"fieldName": "<string>",
"_id": "<string>",
"value": "<string>",
"customFieldDefinitionId": "<string>",
"textValue": "<string>",
"numberValue": 123,
"dateValue": "2023-11-07T05:31:56Z",
"listValue": "<string>"
}
]
},
"notes": [
"<string>"
],
"autoUpdate": true,
"overwriteMode": "askBeforeOverwriting"
}
]
}
'const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
contacts: [
{
contact: {
_id: '<string>',
firstName: '<string>',
middleName: '<string>',
lastName: '<string>',
socialUrl: '<string>',
email: '[email protected]',
workEmail: '[email protected]',
privateEmail: '[email protected]',
otherEmails: ['[email protected]'],
workPhone: '<string>',
privatePhone: '<string>',
otherPhones: ['<string>'],
workMobilePhone: '<string>',
privateMobilePhone: '<string>',
otherMobilePhones: ['<string>'],
summary: '<string>',
tags: ['<string>'],
customFieldList: [
{
fieldName: '<string>',
_id: '<string>',
value: '<string>',
customFieldDefinitionId: '<string>',
textValue: '<string>',
numberValue: 123,
dateValue: '2023-11-07T05:31:56Z',
listValue: '<string>'
}
]
},
notes: ['<string>'],
autoUpdate: true,
overwriteMode: 'askBeforeOverwriting'
}
]
})
};
fetch('https://my.jobin.cloud/api/openapi/v1/contacts/import/bulk', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://my.jobin.cloud/api/openapi/v1/contacts/import/bulk"
payload = { "contacts": [
{
"contact": {
"_id": "<string>",
"firstName": "<string>",
"middleName": "<string>",
"lastName": "<string>",
"socialUrl": "<string>",
"email": "[email protected]",
"workEmail": "[email protected]",
"privateEmail": "[email protected]",
"otherEmails": ["[email protected]"],
"workPhone": "<string>",
"privatePhone": "<string>",
"otherPhones": ["<string>"],
"workMobilePhone": "<string>",
"privateMobilePhone": "<string>",
"otherMobilePhones": ["<string>"],
"summary": "<string>",
"tags": ["<string>"],
"customFieldList": [
{
"fieldName": "<string>",
"_id": "<string>",
"value": "<string>",
"customFieldDefinitionId": "<string>",
"textValue": "<string>",
"numberValue": 123,
"dateValue": "2023-11-07T05:31:56Z",
"listValue": "<string>"
}
]
},
"notes": ["<string>"],
"autoUpdate": True,
"overwriteMode": "askBeforeOverwriting"
}
] }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)$headers=@{}
$headers.Add("x-api-key", "<api-key>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://my.jobin.cloud/api/openapi/v1/contacts/import/bulk' -Method POST -Headers $headers -ContentType 'application/json' -Body '{
"contacts": [
{
"contact": {
"_id": "<string>",
"firstName": "<string>",
"middleName": "<string>",
"lastName": "<string>",
"socialUrl": "<string>",
"email": "[email protected]",
"workEmail": "[email protected]",
"privateEmail": "[email protected]",
"otherEmails": [
"[email protected]"
],
"workPhone": "<string>",
"privatePhone": "<string>",
"otherPhones": [
"<string>"
],
"workMobilePhone": "<string>",
"privateMobilePhone": "<string>",
"otherMobilePhones": [
"<string>"
],
"summary": "<string>",
"tags": [
"<string>"
],
"customFieldList": [
{
"fieldName": "<string>",
"_id": "<string>",
"value": "<string>",
"customFieldDefinitionId": "<string>",
"textValue": "<string>",
"numberValue": 123,
"dateValue": "2023-11-07T05:31:56Z",
"listValue": "<string>"
}
]
},
"notes": [
"<string>"
],
"autoUpdate": true,
"overwriteMode": "askBeforeOverwriting"
}
]
}'{
"items": [
{
"contactId": "<string>",
"autoUpdate": true,
"overwriteMode": "overwriteWithNewest"
}
],
"count": 123
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "<string>",
"retryAfterSeconds": 123
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}Send 1–50 contacts in one request. Review each result and save the returned contact identifiers.
If the request is interrupted, check whether the contacts were imported before sending it again.
Rate limit: 30 requests/minute per endpoint and workgroup. Details.
Authorizations
Primary public authentication method. Create keys in Jobin.cloud under Workgroups > Integrations > Custom integration.
Body
application/json
One to fifty contact import requests. Each item follows POST /contacts/import semantics so dedupe, notes, tags, overwrite mode, and optional auto-update stay consistent.
Required array length:
1 - 50 elementsShow child attributes
Show child attributes