Skip to main content
POST
Assign contacts to a campaign
This is the primary launch endpoint for sequence-driven outreach in the public Jobin API. The 202 Accepted response includes jobGroupId and queuedStagePositionCode. Use the returned jobGroupId with GET /operations to inspect currently outstanding sequence operations. An empty pending result is not a completion or success signal.

Authorizations

x-api-key
string
header
required

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

Path Parameters

campaignId
string
required

Body

application/json
contactIds
string[]
required

Contacts to assign in this request. Jobin accepts up to 50 contacts per campaign-assignment call.

Required array length: 1 - 50 elements
startPositionCode
string
default:""

Response

Assignment accepted

accepted
boolean
campaignId
string
contactIds
string[]
jobGroupId
string

Correlation id for listing outstanding operations created by this asynchronous assignment.

queuedStagePositionCode
string

The sequence stage position used for newly queued operations.