Skip to navigation
Client APIJob Posts

Create a job post

Create a job post. Create an open job post for a hirer at your client account. If the hirer does not already exist, one is provisioned and invited. For onsite, any and hybrid work, the job post uses the given client address, or the client's default address if none is given.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
hirerobjectRequired

The hirer the job post is created for. If the email does not match an existing hirer at your client account, one is provisioned and sent an invitation. The names are only used when a hirer is created; an existing hirer is returned unchanged.

disciplinestringRequired<=40 characters

The identifier of the discipline. Get valid identifiers from GET /disciplines/.

titlestringRequired<=140 characters
The job post title.
descriptionstringRequired
Free text describing the role. At least 50 characters and 10 words.
durationstringRequired<=400 characters
Free text for the expected duration, e.g. "3 months".
currencyenumRequired

The currency for the day rate. Must be a currency your client account allows.

  • AUD - $ AUD
  • CAD - $ CAD
  • CHF - ₣ CHF
  • CZK - Kč CZK
  • DKK - kr DKK
  • EUR - € EUR
  • GBP - £ GBP
  • HKD - $ HKD
  • INR - ₹ INR
  • NOK - kr NOK
  • NZD - $ NZD
  • PLN - zł PLN
  • SEK - kr SEK
  • SGD - $ SGD
  • AED - د.إ AED
  • USD - $ USD
  • ZAR - R ZAR
day_ratestringRequiredformat: "decimal"
The day rate, in the given currency.
remote_workingenumRequired

Where the contractor will work.

  • onsite - Fully on-site
  • remote - Fully remote
  • any - Can work on-site or remote
  • hybrid - Required on-site some days a week
Allowed values:
start_datestringRequiredformat: "date"
The expected start date. Cannot be in the past.
client_addressstringOptional<=40 characters

The identifier of the client address for on-site work. Get valid identifiers from GET /client_addresses/. Only allowed when remote_working is onsite, any or hybrid. If left out, the client's default address is used. If left out and the client has no default address, the request fails with a 422.

days_onsite_per_weekinteger or nullOptional1-7

Days on-site per week. Only allowed when remote_working is hybrid.

disclose_ratebooleanOptionalDefaults to true
Whether freelancers can see the day rate. Defaults to true.
is_solo_projectbooleanOptionalDefaults to true
Whether the contractor works alone rather than in a team. Defaults to true.
is_date_flexiblebooleanOptionalDefaults to true
Whether the start date can move. Defaults to true.
has_project_startedbooleanOptionalDefaults to false
Whether the work is already under way. Defaults to false.

Response

This endpoint returns an object.
dataobject

The job post object (a Brief internally).

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error