---
title: "Create job"
url: "https://earlyaccess.developers.bynder.com/apis/workflow-jobs-api-1/versions/fe891cd9-8e8e-454e-83d7-5e79bbd56714/paths/api-workflow-jobs/post"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/workflow-jobs-api-1/versions/fe891cd9-8e8e-454e-83d7-5e79bbd56714.md

# Create job

`POST` `/api/workflow/jobs`

Requires the JOBADD security role.

## Request body (required)

Content types: `application/json`

## Responses

- `201` - Job created successfully

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Workflow Jobs API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}
paths:
  /api/workflow/jobs:
    post:
      description: Requires the JOBADD security role.
      requestBody:
        content:
          application/json:
            schema:
              properties:
                accountableID:
                  description: Id of the user responsible for the job
                  example: 00000000-0000-0000-0000-000000000000
                  type: string
                campaignID:
                  description: Id of the campaign the job is part of
                  example: 00000000-0000-0000-0000-000000000000
                  type: string
                deadline:
                  description: Date of when the job ends
                  example: 2018-09-29
                  type: string
                description:
                  description: Description of the job
                  example: Job Description
                  type: string
                jobMetaproperties:
                  additionalProperties:
                    type: string
                  description: ID and metaproperty values
                  example:
                    00000000-0000-0000-0000-000000000000: 00000000-0000-0000-0000-000000000000
                  type: object
                name:
                  description: Name of the job
                  example: Job Example
                  type: string
                presetID:
                  description: Id of the preset the job should be created from
                  example: 00000000-0000-0000-0000-000000000000
                  type: string
                stages:
                  items:
                    properties:
                      deadline:
                        description: Deadline date of stage
                        example: 2018-09-29
                        type: string
                      description:
                        description: Description of the stage
                        example: Awesome description
                        type: string
                      name:
                        description: Name of the stage
                        example: Review
                        type: string
                      preset_stage_id:
                        description: Id of the preset stage
                        example: 00000000-0000-0000-0000-000000000000
                        type: string
                      responsibleGroupID:
                        description: Id of responsible group for the stage
                        example: 00000000-0000-0000-0000-000000000000
                        type: string
                      responsibleID:
                        description: Id of the stage responsible
                        example: 00000000-0000-0000-0000-000000000000
                        type: string
                    type: object
                  type: array
              type: object
        required: true
      responses:
        "201":
          content:
            application/json:
              examples:
                example-1:
                  value:
                    job_id: 00000000-0000-0000-0000-000000000000
                    status: Created
              schema:
                properties:
                  job_id:
                    example: 00000000-0000-0000-0000-000000000000
                    type: string
                  status:
                    example: Created
                    type: string
                type: object
          description: Job created successfully
      security:
        - permanentToken:
            - JOBADD
        - OAuth2:
            - JOBADD
      summary: Create job
      tags:
        - Jobs
security:
  - permanentToken:
      - JOBADD
  - OAuth2:
      - JOBADD
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            CAMPAIGNOVERVIEW: ""
            JOBADD: ""
            JOBAPPROVE: ""
            JOBEDIT: ""
            JOBOVERVIEW: ""
            JOBREMOVE: ""
            PRESETOVERVIEW: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            CAMPAIGNOVERVIEW: ""
            JOBADD: ""
            JOBAPPROVE: ""
            JOBEDIT: ""
            JOBOVERVIEW: ""
            JOBREMOVE: ""
            PRESETOVERVIEW: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
```