Create Onboarding Job

Use this API when your system needs to start an onboarding journey for a candidate and receive the onboarding link immediately in the response.

What you need from OnBo

Your API key must be journey-bound (provisioned for a specific onboarding journey).

How to get your API key ID and secret

1. Sign in to the OnBo dashboard: https://dashboard.idmission.com 
2. Open Journey Settings → Credentials
3. Click Create keys
4. Copy the API key ID and API key secret shown after creation

Store the secret securely — it is shown only once at creation time. Send them as the X-Api-Key-Id and X-Api-Key-Secret request headers when calling the API — never in the request body.

Create a separate key per journey if you run multiple onboarding flows.

How it works

1. Your backend calls POST https://portal.idmission.com/api/create-onboarding-link with the X-Api-Key-Id and X-Api-Key-Secret headers and the candidate details in the JSON body.
2. OnBo validates the API key, derives the journey from the key, and creates the job.
3. The response includes onboardingLink — send it to the candidate or open it in your app.

Quick start

curl -X POST "https://portal.idmission.com/api/create-onboarding-link" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key-Id: urn:apikeysv1:prod:region:company:YOUR_KEY_UUID" \
  -H "X-Api-Key-Secret: YOUR_API_KEY_SECRET" \
  -d '{
    "name": "Jane Doe",
    "phone": "+15551234567",
    "email": "jane@example.com",
    "firstDayOfEmployment": "03/15/2026",
    "channel": ["sms", "email"]
  }'

See Create Onboarding Job API for the full request/response reference, validation rules, and error handling.

Related documentation

• Create Onboarding Job API — full integration reference
• Get Job Data API — retrieve full onboarding job data by job ID