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
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
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.
The identifier of the discipline. Get valid identifiers from GET /disciplines/.
The currency for the day rate. Must be a currency your client account allows.
AUD- $ AUDCAD- $ CADCHF- ₣ CHFCZK- Kč CZKDKK- kr DKKEUR- € EURGBP- £ GBPHKD- $ HKDINR- ₹ INRNOK- kr NOKNZD- $ NZDPLN- zł PLNSEK- kr SEKSGD- $ SGDAED- د.إ AEDUSD- $ USDZAR- R ZAR
Where the contractor will work.
onsite- Fully on-siteremote- Fully remoteany- Can work on-site or remotehybrid- Required on-site some days a week
Your own identifier for this job post. Sending the same value again returns the job post you already created, rather than creating another, so a retry after a timeout is safe. Leave it out and a retry creates a second job post.
The first job post is returned unchanged. The rest of the request is ignored, so a different title or hirer has no effect, and a job post that has since been cancelled, expired or turned into a contract is still what you get back. Use a new external_id to create a new job post.
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 on-site per week. Only allowed when remote_working is hybrid.
Response
A job post with this external_id already exists. The one you created first is returned, and nothing new is created.
The job post object (a Brief internally).