Skip to main content
POST
https://connect.jobo.world
/
api
/
auto-apply
/
run
curl -X POST https://connect.jobo.world/api/auto-apply/run \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{
    "profile_id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
    "apply_url": "https://boards.greenhouse.io/acme/jobs/1234567"
  }'

{
  "session_id": "e8e4cc3f-8d9f-4878-b4f3-6dc61d0cbbe4",
  "profile_id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
  "apply_url": "https://boards.greenhouse.io/acme/jobs/1234567",
  "provider_id": "greenhouse",
  "provider_display_name": "Greenhouse",
  "status": "Submitted",
  "success": true,
  "error": null,
  "steps_completed": 3,
  "fields_filled": 12,
  "duration_ms": 8420,
  "step_log": [
    {
      "step": 1,
      "action": "fill_form",
      "status": "completed",
      "fields_count": 6,
      "error": null,
      "timestamp": "2026-03-01T14:00:01.123Z"
    },
    {
      "step": 2,
      "action": "navigate_next",
      "status": "completed",
      "fields_count": 0,
      "error": null,
      "timestamp": "2026-03-01T14:00:03.456Z"
    },
    {
      "step": 3,
      "action": "fill_form",
      "status": "completed",
      "fields_count": 4,
      "error": null,
      "timestamp": "2026-03-01T14:00:05.789Z"
    },
    {
      "step": 4,
      "action": "navigate_next",
      "status": "completed",
      "fields_count": 0,
      "error": null,
      "timestamp": "2026-03-01T14:00:06.100Z"
    },
    {
      "step": 5,
      "action": "fill_form",
      "status": "completed",
      "fields_count": 2,
      "error": null,
      "timestamp": "2026-03-01T14:00:07.200Z"
    },
    {
      "step": 6,
      "action": "submit",
      "status": "completed",
      "fields_count": 0,
      "error": null,
      "timestamp": "2026-03-01T14:00:08.420Z"
    }
  ]
}
This is the recommended approach for production usage. It handles the full application flow automatically — session creation, form filling, page navigation, and submission — in a single request. If you need more granular control (e.g., inspecting fields before answering, custom retry logic per page), use the manual Start Session → Set Answers → End Session flow instead.

​
Pricing

Each run costs 200 credits (same as a manual session).
​
profile_id
string
required
The auto-apply profile ID (UUID) containing the applicant’s information — name, email, resume, work authorization answers, etc.
​
apply_url
string
required
Job application URL for a supported ATS provider. Example: "https://boards.greenhouse.io/acme/jobs/1234567"
​
session_id
string
UUID of the session that was created and used during the flow.
​
profile_id
string
Profile ID that was used for the application.
​
apply_url
string
The job application URL that was submitted to.
​
provider_id
string
ATS provider identifier (e.g., "greenhouse", "lever").
​
provider_display_name
string
Human-readable provider name (e.g., "Greenhouse", "Lever").
​
status
string
Final status of the application. See Flow States.
​
success
boolean
Whether the application was submitted successfully.
​
error
string
Error message if the application failed. null on success.
​
steps_completed
integer
Number of form pages completed during the flow.
​
fields_filled
integer
Total number of fields filled across all pages.
​
duration_ms
integer
Total execution time in milliseconds.
​
step_log
object[]
Detailed log of each step in the flow. Each entry contains: - step (integer) — Step number (1-based) - action (string) — What was done (e.g., "fill_form", "navigate_next") - status (string) — Step result - fields_count (integer) — Number of fields processed in this step - error (string, nullable) — Error message if the step failed - timestamp (string) — ISO 8601 timestamp of when the step executed
curl -X POST https://connect.jobo.world/api/auto-apply/run \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{
    "profile_id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
    "apply_url": "https://boards.greenhouse.io/acme/jobs/1234567"
  }'

{
  "session_id": "e8e4cc3f-8d9f-4878-b4f3-6dc61d0cbbe4",
  "profile_id": "a1b2c3d4-5678-9abc-def0-1234567890ab",
  "apply_url": "https://boards.greenhouse.io/acme/jobs/1234567",
  "provider_id": "greenhouse",
  "provider_display_name": "Greenhouse",
  "status": "Submitted",
  "success": true,
  "error": null,
  "steps_completed": 3,
  "fields_filled": 12,
  "duration_ms": 8420,
  "step_log": [
    {
      "step": 1,
      "action": "fill_form",
      "status": "completed",
      "fields_count": 6,
      "error": null,
      "timestamp": "2026-03-01T14:00:01.123Z"
    },
    {
      "step": 2,
      "action": "navigate_next",
      "status": "completed",
      "fields_count": 0,
      "error": null,
      "timestamp": "2026-03-01T14:00:03.456Z"
    },
    {
      "step": 3,
      "action": "fill_form",
      "status": "completed",
      "fields_count": 4,
      "error": null,
      "timestamp": "2026-03-01T14:00:05.789Z"
    },
    {
      "step": 4,
      "action": "navigate_next",
      "status": "completed",
      "fields_count": 0,
      "error": null,
      "timestamp": "2026-03-01T14:00:06.100Z"
    },
    {
      "step": 5,
      "action": "fill_form",
      "status": "completed",
      "fields_count": 2,
      "error": null,
      "timestamp": "2026-03-01T14:00:07.200Z"
    },
    {
      "step": 6,
      "action": "submit",
      "status": "completed",
      "fields_count": 0,
      "error": null,
      "timestamp": "2026-03-01T14:00:08.420Z"
    }
  ]
}