---
title: "Create Job"
method: POST
path: "/rest/api/consent/v4/jobs"
tags: ["Jobs"]
---

# Create Job

`POST /rest/api/consent/v4/jobs`

## Request

- Base URL: `https://hostname`
- URL: `https://hostname/rest/api/consent/v4/jobs`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://{hostname}/api/access/v1/oauth/token` scopes: `CONSENT`

Use this API to create a new schedule job for data subject bulk actions.

## Request body

- ConsentAPIJobCreateRequest
  - `EntityId` string, required: The unique identifier of the entity for which the job is being created.
  - `Name` string, required: The name of the job.
  - `Description` string: The description of the job.
  - `Type` 'consent_ds_bulk_actions': The type of job.
  - `Token` string, required: The authentication token required to execute the job.

## Response `200`

OK

- ConsentAPIJobResponse
  - `Id` string, uuid: The unique identifier of the scheduled job.
  - `Name` string: The name of the job.
  - `Description` string: The description of the job.
  - `TypeId` string: The type of job.
  - `Status` 'Pending' | 'In Progress' | 'Error' | 'Completed': The status of the job.
  - `StatusId` integer: The numeric status identifier of the job.
  - `ErrorCount` integer: The number of errors encountered during job execution.
  - `CreatedBy` string, uuid: The unique identifier of the user who created the job.
  - `CreatedDate` string, date-time: The date and time that the job was created.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500`: Internal Server Error

---

[API](https://skmtc.dev/onetrust/apis/consent-preferences-universal-consent-preference-management.md) - [All operations](https://skmtc.dev/onetrust/apis/consent-preferences-universal-consent-preference-management/llms.txt) - [OpenAPI document](https://skmtc.dev/onetrust/apis/consent-preferences-universal-consent-preference-management/revisions/fe4a0697ec9d?raw)