BIbindbee
Job

Create Job

Changed on

Creates a Job object with the given values.

post/api/ats/v1/jobs

Request

  • Base URL
    https://api.bindbee.dev (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer and API key in header X-Connector-Token

Request body

namestring nullable

The name of the job.

descriptionstring nullable

A detailed description of the job.

codestring nullable

The internal or external code that identifies the job.

statusstring nullable

The current status of the job posting. If the value is not one of the defined enum values, the original value passed through will be returned.

confidentialboolean nullable

Whether the job posting is confidential.

departmentsstring[] nullable

A list of department identifiers associated with the job.

officesstring[] nullable

A list of office identifiers where the job is located.

hiring_managersstring[] nullable

A list of identifiers for hiring managers associated with the job.

recruitersstring[] nullable

A list of identifiers for recruiters associated with the job.

template_idstring nullable

The template id associated with the job.

remote_user_idstring uuid nullable

The remote user's id who is creating the job.

openingsinteger nullable

Number of openings for the job.

Example request

{
  "name": "SOFTWARE ENGINEER",
  "description": "We are looking for a software engineer to join our team.",
  "code": "SE-2021-01",
  "status": "OPEN",
  "template_id": "018b4bfb-5ece-70b1-ad5e-862a9433aa65",
  "remote_user_id": "018b4bfb-5ece-70b1-ad5e-862a9433aa65",
  "openings": 3
}

Response

Successful Response

unknown required

Changes

  • 1f9bc0ad4bfbRevision changes
    • breaking

      removed the enum value - of the request property ///

    • breaking

      removed the enum value - of the request property

    • breaking

      removed the enum value ARCHIVED of the request property

    • breaking

      removed the enum value BLOG of the request property ///

    • breaking

      removed the enum value CLOSED of the request property

    • breaking

      removed the enum value COMPANY of the request property ///

    • breaking

      removed the enum value DRAFT of the request property

    • breaking

      removed the enum value JOB_POSTING of the request property ///

    • breaking

      removed the enum value OPEN of the request property

    • breaking

      removed the enum value OTHER of the request property ///

    • breaking

      removed the enum value PENDING of the request property

    • breaking

      removed the enum value PERSONAL of the request property ///

    • breaking

      removed the enum value PORTFOLIO of the request property ///

    • breaking

      removed the enum value SOCIAL_MEDIA of the request property ///

    • info

      the endpoint scheme security HTTPBearer AND ConnectorToken was added to the API

    • info

      the endpoint scheme security ConnectorToken was removed from the API

    • info

      the endpoint scheme security HTTPBearer was removed from the API

  • cf8209fb1cd7Revision changes
    • warning

      deleted the header request parameter x-connector-token

    • info

      the endpoint scheme security ConnectorToken was added to the API