---
title: "Create new job"
method: POST
path: "/v2/bulk-user-operation/job"
tags: ["Bulk Operation Job"]
---

# Create new job

`POST /v2/bulk-user-operation/job`

## Request

- Base URL: `https://api.alianza.com`
- URL: `https://api.alianza.com/v2/bulk-user-operation/job`
- Auth: API key in header `X-AUTH-TOKEN`
- TypeScript: <https://skmtc.dev/alianza/apis/alianza-public-api/docs/v2/bulk-user-operation/job/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new job. This endpoint can take two content types -- application/json and multipart/form-data. Please see the request body examples for the content type you will be using.

## Request body

- JobDTO
  - `id` string: Unique identifier of the job
  - `ownerId` string: Owner identifier of the job
  - `jobTypeId` string, required: Type identifier of the job
  - `targetAccountId` string, required: Target account identifier for the job
  - `inputCollectionId` string, required: Input collection identifier for the job
  - `jobStatus` 'CREATED' | 'STARTED' | 'ABORTED' | 'COMPLETED'
  - `executionStatus` 'CREATED' | 'STARTED' | 'ABORTED' | 'COMPLETED'
  - `updatedDateTime` string, date-time: Timestamp of the last update in ISO 8601 format
  - `outputCollections` object
  - `abortAfter` integer: Time after which the job should be aborted

## Response `200`

Job created successfully

- JobDTO
  - `id` string: Unique identifier of the job
  - `ownerId` string: Owner identifier of the job
  - `jobTypeId` string, required: Type identifier of the job
  - `targetAccountId` string, required: Target account identifier for the job
  - `inputCollectionId` string, required: Input collection identifier for the job
  - `jobStatus` 'CREATED' | 'STARTED' | 'ABORTED' | 'COMPLETED'
  - `executionStatus` 'CREATED' | 'STARTED' | 'ABORTED' | 'COMPLETED'
  - `updatedDateTime` string, date-time: Timestamp of the last update in ISO 8601 format
  - `outputCollections` object
  - `abortAfter` integer: Time after which the job should be aborted

## Other responses

- `400`: Invalid job details supplied
- `403`: Unauthorized access
- `422`: Unprocessable Content

---

[API](https://skmtc.dev/alianza/apis/alianza-public-api.md) - [All operations](https://skmtc.dev/alianza/apis/alianza-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alianza/apis/alianza-public-api/revisions/7223246c352c?raw)
