Create an application

COMING SOON: This operation is a contract preview and does not currently accept beta or production traffic.

Validate and queue a profileless job application. Supply exactly one of job_id or apply_url. Jobo returns immediately and sends discovered form fields to the effective callback URL for your integration to answer.

callback_url is an optional per-application override. When omitted, the account default configured in the Auto Apply portal is copied onto the application. The account must have a webhook secret, and create fails when neither callback URL source is available. The secret cannot be supplied or replaced in this request.

Idempotency-Key is required. Reusing a key with the same canonical body returns the original application for 24 hours; reusing it with a different body returns a conflict.

POST /api/auto-apply/applications

cURL

job_id

curl --request POST \
  --url https://connect.jobo.world/api/auto-apply/applications \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "job_id": "2c1ac0f5-8772-43d2-b5a8-26b44a3fa171"
}
'

202

{
  "api_version": "2026-07-21",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "job_id": "<string>",
  "apply_url": "<string>",
  "provider_id": "<string>",
  "provider_name": "<string>",
  "cancel_requested": true,
  "status_updated_at": "2023-11-07T05:31:56Z",
  "queued_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z",
  "submitted_at": "2023-11-07T05:31:56Z",
  "failed_at": "2023-11-07T05:31:56Z",
  "canceled_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "callback_url": "<string>",
  "provider_version": "<string>",
  "matcher_revision": 123,
  "catalog_revision": 123,
  "settings_revision": 123,
  "failure": {
    "code": "submission_unconfirmed",
    "message": "<string>",
    "retryable": true
  },
  "canceled_by": "<string>",
  "steps": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sequence": 2,
      "status": "answered",
      "correction_round": 1,
      "fields": [
        {
          "field_id": "<string>",
          "label": "<string>",
          "required": true,
          "requires_answer": true,
          "current_value": "<unknown>",
          "options": [
            {
              "value": "<string>",
              "label": "<string>"
            }
          ],
          "constraints": {},
          "category": "<string>",
          "semantic_key": "<string>",
          "sensitive": true,
          "format": "<string>",
          "min_items": 1,
          "max_items": 5,
          "item_fields": [
            {
              "key": "<string>",
              "label": "<string>",
              "required": true,
              "options": [
                {
                  "value": "<string>",
                  "label": "<string>"
                }
              ],
              "constraints": {}
            }
          ]
        }
      ],
      "answers": [
        {
          "field_id": "<string>",
          "value": "<string>"
        }
      ],
      "command_errors": [
        {
          "field_id": "<string>",
          "item_index": 1,
          "field_key": "<string>",
          "code": "invalid_option",
          "message": "<string>"
        }
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "completed_at": "2023-11-07T05:31:56Z",
      "field_count": 1,
      "answer_count": 1
    }
  ],
  "events": [
    {
      "id": "<string>",
      "attempt_count": 1,
      "attempts": [
        {
          "attempt": 2,
          "at": "2023-11-07T05:31:56Z",
          "response_status": 349,
          "error": "<string>"
        }
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "delivered_at": "2023-11-07T05:31:56Z"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "api_version": "2026-07-21"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "api_version": "2026-07-21"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "api_version": "2026-07-21"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "api_version": "2026-07-21"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "api_version": "2026-07-21"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "api_version": "2026-07-21"
}

{
  "title": "auto_apply_coming_soon",
  "status": 503,
  "detail": "Auto Apply application creation is coming soon.",
  "code": "auto_apply_coming_soon",
  "api_version": "2026-07-21"
}

Authorizations

X-Api-Key · string · header · required

API key provided by Jobo

Headers

Idempotency-Key · string · required

Unique key for this create request. Retained for 24 hours.

Required string length: 1 - 200

Body

application/json

Option 1

Option 2

Profileless application target and callback selection. Supply exactly one of job_id and apply_url. callback_url is optional when the account has a default callback; the account webhook secret is configured separately and can never be supplied here.

job_id · string<uuid> · required

Jobo job ID whose current apply URL should be used.

Example:

"2c1ac0f5-8772-43d2-b5a8-26b44a3fa171"

apply_url · string<uri>

Public HTTPS application URL handled by an active Auto Apply provider.

Example:

"https://boards.greenhouse.io/acme/jobs/4567890"

callback_url · string<uri> | null

Optional public HTTPS callback override for this application. When omitted or null, the account default is copied onto the application.

Example:

"https://integrator.example.com/webhooks/jobo"

sandbox · boolean · default: false

Use the deterministic sandbox pipeline and its separate quota.

Callbacks

POST

{$request.body#/callback_url}fieldsRequested

Body

application/json

id · string · required

Stable event ID reused by transport retries.

Example:

"evt_a6b0381d7d9f452a928641f216a0b88f"

type · enum<string> · required

Available options: application.fields_requested

api_version · enum<string> · required

Version of the profileless Auto Apply API contract.

Available options: 2026-07-21

Example:

"2026-07-21"

attempt · integer · required

Logical event attempt. Use X-Jobo-Delivery-Attempt for transport retries.

Required range: x >= 1

created_at · string<date-time> · required

application · object · required

Show child attributes

step · object · required

Show child attributes

Response

400

Callback receiver rejected an invalid signature or event.

POST

{$request.body#/callback_url}terminalEvent

Body

application/json

id · string · required

Stable event ID reused by delivery retries.

type · enum<string> · required

Available options: application.submitted, application.failed, application.canceled

api_version · enum<string> · required

Version of the profileless Auto Apply API contract.

Available options: 2026-07-21

Example:

"2026-07-21"

attempt · integer · required

Required range: x >= 1

created_at · string<date-time> · required

application · object · required

Show child attributes

Response

400

Callback receiver rejected an invalid signature or event.

Response

202

application/json

Application durably accepted in queued state.

api_version · enum<string> · required

Version of the profileless Auto Apply API contract.

Available options: 2026-07-21

Example:

"2026-07-21"

id · string<uuid> · required

Stable application ID.

job_id · string | null · required

Supplied Jobo job ID, or null when apply_url was supplied directly.

apply_url · string<uri> · required

Resolved application URL.

provider_id · string · required

Stable provider identifier selected at intake.

provider_name · string · required

Provider display name captured at intake.

status · enum<string> · required

Current durable application state.

Available options: queued, running, awaiting_answers, submitted, failed, canceled

cancel_requested · boolean · required

Whether cancellation has been requested.

status_updated_at · string<date-time> · required

queued_at · string<date-time> · required

started_at · string<date-time> | null · required

submitted_at · string<date-time> | null · required

failed_at · string<date-time> | null · required

canceled_at · string<date-time> | null · required

completed_at · string<date-time> | null · required

submitted_at, failed_at, or canceled_at, whichever is set.

created_at · string<date-time> · required

callback_url · string<uri> · required

Effective callback URL captured when the application was created.

callback_source · enum<string> · required

Where the effective callback URL came from.

Available options: account_default, application_override

provider_version · string · required

Provider implementation version captured at intake.

matcher_revision · integer<int64> · required

catalog_revision · integer<int64> · required

settings_revision · integer<int64> · required

failure · object | null · required

Show child attributes

canceled_by · string | null · required

Actor that completed cancellation, when applicable.

steps · object[] · required

Show child attributes

events · object[] · required

Terminal webhook deliveries and their attempts.

Show child attributes