---
title: "Create a new eligibility job"
method: POST
path: "/v1/eligibility/jobs"
tags: ["Jobs"]
---

# Create a new eligibility job

`POST /v1/eligibility/jobs`

## Request

- Base URL: `https://api.clients.wellhub.com`
- URL: `https://api.clients.wellhub.com/v1/eligibility/jobs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/wellhub/apis/integrations-api/docs/v1/eligibility/jobs/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new eligibility batch job in draft state. After creation, add items to the job using `POST /v1/eligibility/jobs/{job-id}/items`, then submit it using `POST /v1/eligibility/jobs/{job-id}/submit`.

## Response `201`

Created. Returns the newly created job's ID.

- JobResponse
  - `id` string, uuid: The UUID of the newly created job.

## Other responses

- `401`: Unauthorized. Missing or invalid Bearer token.
- `403`: Forbidden. The authenticated entity does not have permission to create jobs.
- `500`: Internal Server Error.

---

[API](https://skmtc.dev/wellhub/apis/integrations-api.md) - [All operations](https://skmtc.dev/wellhub/apis/integrations-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wellhub/apis/integrations-api/revisions/3e6a46a18a2e?raw)