Assign contacts to a campaign
curl --request POST \
--url https://my.jobin.cloud/api/openapi/v1/campaigns/{campaignId}/contacts \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"contactIds": [
"6806d18d5f0c4a4f2f780001"
]
}
'const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({contactIds: ['6806d18d5f0c4a4f2f780001']})
};
fetch('https://my.jobin.cloud/api/openapi/v1/campaigns/{campaignId}/contacts', 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/campaigns/{campaignId}/contacts"
payload = { "contactIds": ["6806d18d5f0c4a4f2f780001"] }
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/campaigns/{campaignId}/contacts' -Method POST -Headers $headers -ContentType 'application/json' -Body '{
"contactIds": [
"6806d18d5f0c4a4f2f780001"
]
}'{
"accepted": true,
"campaignId": "aaaaaaaaaaaaaaaaaaaaaaaa",
"contactIds": [
"bbbbbbbbbbbbbbbbbbbbbbbb"
],
"jobGroupId": "cccccccccccccccccccccccc",
"queuedStagePositionCode": "first-touch"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"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"
}Campaigns
Assign contacts to a campaign
Start a Jobin outreach sequence for selected contacts.
POST
/
campaigns
/
{campaignId}
/
contacts
Assign contacts to a campaign
curl --request POST \
--url https://my.jobin.cloud/api/openapi/v1/campaigns/{campaignId}/contacts \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"contactIds": [
"6806d18d5f0c4a4f2f780001"
]
}
'const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({contactIds: ['6806d18d5f0c4a4f2f780001']})
};
fetch('https://my.jobin.cloud/api/openapi/v1/campaigns/{campaignId}/contacts', 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/campaigns/{campaignId}/contacts"
payload = { "contactIds": ["6806d18d5f0c4a4f2f780001"] }
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/campaigns/{campaignId}/contacts' -Method POST -Headers $headers -ContentType 'application/json' -Body '{
"contactIds": [
"6806d18d5f0c4a4f2f780001"
]
}'{
"accepted": true,
"campaignId": "aaaaaaaaaaaaaaaaaaaaaaaa",
"contactIds": [
"bbbbbbbbbbbbbbbbbbbbbbbb"
],
"jobGroupId": "cccccccccccccccccccccccc",
"queuedStagePositionCode": "first-touch"
}{
"code": "UNHANDLED_EXCEPTION",
"error": "Unexpected error"
}{
"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"
}Review the contacts, sequence messages, timing, and sender before assigning contacts.
Jobin starts the configured sequence after assignment.
The
202 Accepted response confirms that Jobin queued the work. It includes jobGroupId and queuedStagePositionCode.
Use jobGroupId with List operations to check related work.
Review the contact’s sequence activity to confirm the outcome, including when the pending list is empty.
Rate limit: 10 requests/minute per endpoint and workgroup. Details.Authorizations
Body
application/json
