Post Job

Use the JobBoard.io API to create a single job

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

API requests are made via HTTPS using your account’s unique API key. Each request must be authenticated by including this API key in the request header as X-Api-Key. You can find your API token in Site Config.

The request header must contain your X-Api-Key, available in Site Config. Each request header must also contain "Content-Type: application/json".

The request body must contain:

Request KeyRequest Value ExampleRequired?
titleDeveloperYes
companyAppleYes
locationLondonYes
apply_urlhttp://careers.apple.comMust have an apply method (apply_url or apply_email)
apply_email[email protected]Must have an apply method (apply_url or apply_email)
description

We are building a new platform for linking virtual content to locations.

We use QR codes, low energy bluetooth, and other hardware.

Join our team today!

Yes
contact_email[email protected]Yes. Please note if missing the error response will be "purchaser_email" can't be blank.
publishedtrue or falseYes
featuredtrue or falseYes
job_typeAccepts String Values of Job Type - For example: "Full Time", "Part Time"No

Successful POST Response Example

{
  "message": "Job created successfully.",
}

Unsuccessful POST Response Example

When purchase email, nor apply method was correctly specified.

{
  "message": {
    "purchaser_email": [
      "can't be blank"
    ],
    "base": [
      "You must provide an apply method."
    ]
  }
}
Body Params
string
required
Defaults to Developer

Job Name

string
required
Defaults to Apple

Company Name

string
required
Defaults to London

Location

string

Is the job remote? Options are "full", "hybrid" and "on_site". Full - Job is 100% Remote. Location is not required if Remote is set to "Full". Hybrid - Job is set to hybrid - which is a mix of onsite and remote. Onsite - Work must be conducted at the location specified in the "location" field.

string
required
Defaults to Test Description

Description

string
required
Defaults to [email protected]

Contact email for poster

string
required
Defaults to [email protected]

Apply Email (Either Apply Email OR Apply URL is required)

string
required
Defaults to http://careers.apple.com

Apply URL (Either Apply Email OR Apply URL is required)

string

Additional Application Instructions

string

36 character string identifying an employer. Can be found in the URL of the Employer of your admin panel. If an employer does not have an Active Package, the request will fail.

string
Defaults to http://careers.apple.com

Company URL

string

A direct URL link to an image - for example - http://jobboard.io/logo.png

string
Defaults to false

To automatically publish jobs, send true.

string

Posting Date. Required Format: MM/DD/YY

string

Expiration date. Required Format: MM/DD/YY

string

Accepts String Values of Job Type - For example: "Full Time", "Part Time"

string

Add a taxonomy to the job posting. A semicolon separate list of taxonomy values is supported. Eg: "my_taxonomy_name": "value1;value2;value4",

string

Provide a reference ID - this will enable you to edit/delete the job in future

float

The minimum salary for the job posting

float

The maximum salary for the position

string

Pick one: USD CAD GBP EUR AUD NZD DKK SEK SGD ZAR HKD

string
Defaults to Annually

Pick one: Annually, Monthly, Hourly, Weekly

boolean
Defaults to false

Show the salary in the public job description (True = 1, False - 0)

string

Additional compensation information (benefits, etc.)

boolean
Defaults to false
boolean
Defaults to false

Mark the job Urgent?

string

Where is the job from? This will be included in the job table in the admin panel.

string

Must be JSON. Please contact support for assistance and examples.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json