---
title: "Create job"
method: POST
path: "/jobs-api/v3/projects/{projectId}/jobs"
tags: ["Jobs"]
---

# Create job

`POST /jobs-api/v3/projects/{projectId}/jobs`

Creates a job within Smartling.

## Path parameters

- `projectId` string, required

## Request body

- CreateJobRequest — The payload to use when creating a job.
  - `jobName` string — The name of the job to create. It must be unique within the Smartling project. `jobName` is **required**.
  - `targetLocaleIds` string[] — The array of `localeId`s to be used when creating the job. The locales specified must be valid within the Smartling project.
  - `description` string — The description of the job. The description is limited to 8,000 characters.
  - `dueDate` string, date-time — The date the job is requested to be completed by.
  - `referenceNumber` string — Customer specific number/identifier for the job.
  - `callbackUrl` string — The URL for Smartling to invoke when the job is completed.
  - `callbackMethod` string — The HTTP method to call (GET|POST) when invoking the `callbackUrl`.
  - `customFields` CustomFieldBasicRequest[] — Custom fields assigned to the project which job is created in. Validation on custom fields is done in scope of that request.
    - `fieldUid` string — Custom field unique identifier.
    - `fieldValue` string — Custom field value.

## Response `200`

OK

- ShallowJobResponse
  - `response` object, required
    - `code` 'SUCCESS', required — Indicates whether the response was successful or what error has occured.
    - `data` object
      - `callbackMethod` string — The http method (GET|POST) to use when Smartling invokes the callback URL upon job completion.
      - `callbackUrl` string — The callback URL to invoke when a job is completed.
      - `createdByUserUid` string — The userUid of who created the job.
      - `createdDate` string, date-time — The UTC value of the date the job was created.
      - `description` string — The description of the job.
      - `dueDate` string, date-time — The UTC value of the due date for the job.
      - `firstCompletedDate` string, date-time — The UTC value of when the job was first completed.
      - `firstAuthorizedDate` string, date-time — The UTC value of when the job was first authorized.
      - `jobName` string — The name of the job.
      - `jobNumber` string — The account level unique number of the job. Consist of unique short prefix and sequence number.
      - `jobStatus` string — The status of the job.
      - `lastCompletedDate` string, date-time — The UTC value of when the job was last completed.
      - `lastAuthorizedDate` string, date-time — The UTC value of when the job was last authorized.
      - `modifiedByUserUid` string — The userUid of who last modified the job.
      - `modifiedDate` string, date-time — The UTC value of the date the job was modified.
      - `targetLocaleIds` string[] — The array of localeIds for the job.
      - `customFields` CustomFieldBasicResponse[]
        - `fieldUid` string — Custom field unique identifier.
        - `fieldName` string — Custom field name.
        - `fieldValue` string — Custom field value.
      - `translationJobUid` string — The unique identifier for the job.
      - `referenceNumber` string — Customer specific number/identifier for the job.
      - `issues` IssuesCount
        - `sourceIssuesCount` integer — Source inssues count.
        - `translationIssuesCount` integer — Translation inssues count.

## Other responses

- `400` — Validation error during job creation.
- `401` — Provided credentials are not valid.
- `429` — Too many simultaneous API requests.
- `500` — Unexpected error

---

[API](https://skmtc.net/smartling/apis/smartling-rest-api-reference.md) · [All operations](https://skmtc.net/smartling/apis/smartling-rest-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartling/smartling-rest-api-reference/versions/2a73d11e9b98/schema)