Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Your organization API key, available in Organisation settings.

Body

application/json
description
string
required

Job description

It can be plain text or HTML (we sanitise it to keep only basic tags)

Example:

"I am searching for a talented developer to join our team! The stack includes javascript, react, and nodejs."

accountEmail
string<email>

Email of the account on Collective under which this job will be posted. If not specified, the first account found will be picked. This field can only be set at creation.

internalJobId
string

Your unique identifier for the job. This field can only be set at creation. Use it as the id when retrieving, updating, or closing the job. If omitted, responses return internalJobId as null. See Job identifiers.

Example:

"open-ai-fullstack-engineer-123"

contractType
enum<string>
default:FREELANCE

The contract type for the job

Values should be one of FREELANCE or PERMANENT_CONTRACT.

Available options:
FREELANCE,
PERMANENT_CONTRACT
Example:

"FREELANCE"

companyLogoUrl
string<uri>

URL of the company logo

Example:

"https://openai.com/logo.png"

companyName
string

Name of the company

If not specified, we will default to the recruiter's account default company

Example:

"OpenAI.com"

title
string

Job title

If not specified, we will try to infer it

Note: In sandbox, we add the [Sandbox] prefix to the job title to prevent mistakes

Example:

"Senior Fullstack Developer"

profileWanted
string

Description of the ideal candidate profile - ⚠️ If you want your offer to perform and be multi posted well, we highly recommend filling this field.

It can be plain text or HTML (we sanitise it to keep only basic tags)

Example:

"We are looking for a senior engineer with 5+ years of experience in distributed systems and a strong background in cloud infrastructure."

isSalaryAccordingToProfile
boolean

Whether the salary is open to negotiation and based on the candidate profile - ⚠️ We don't recommend setting this to true as jobs without salary perform way worse.

When set to true, the salary/budget will be displayed as "According to profile" on the job posting, overriding any budget value specified.

budget
string

Salary for the position - ⚠️ If you want your offer to perform and be multi posted well, we highly recommend filling this field.

If not specified, we will try to infer it or default to empty.

Note: there is no need to set this field when isSalaryAccordingToProfile is true.

Example:

"1250€/day or 80-100K€/year"

startingDate
enum<string>

Start date for the position

If not specified, we will try to infer it or default to IN_2_TO_4_WEEKS

Available options:
ASAP,
IN_2_TO_4_WEEKS,
IN_4_TO_8_WEEKS,
IN_8_WEEKS_OR_MORE
Example:

"IN_2_TO_4_WEEKS"

expirationDate
string<date>

Max date until which users can apply to the job

Date should be in "YYYY-MM-DD" format.

If not specified, we will try to infer it or default to "In 2 weeks from now".

Example:

"2026-11-29"

notifyByEmailForEveryApplication
boolean
default:false

Controls whether the recruiter who posted the job will be notified by email for every application. Defaults to false.

requirePhoneNumber
boolean
default:false

Whether phone number is required for application

requireResume
boolean
default:true
deprecated

Whether resume is required for application (deprecated - resume is always required now)

questions
string[]

Questions asked to applicants. This field can only be set at creation.

Maximum array length: 4
Example:
skills
string[]

Required skills for the position

We will match it also with our skills database to improve the job visibility, which may result in skills being added or tweaked.

Example:
workPreferences
string

Work arrangement preferences (remote, hybrid, on-site)

Values should be one of ON_SITE (no remote allowed at all), HYBRID (some remote allowed, but still ne to come onsite), or REMOTE (no need to come to the office).

If not specified, we will try to infer it.

Example:

"ON_SITE"

location
string

Job location. We only accept a city (no region, or country, and we don't accept multiple cities - create 2 different jobs for that).

If not specified, we will try to infer it.

This field is a string but will be automatically remapped to an exact location in the google maps API.

Example:

"San Francisco, CA"

language
enum<string>

Language of the job posting

Values should be one of en (English) or fr (French).

If not specified, the language will be automatically detected.

Available options:
en,
fr
Example:

"fr"

Response

Job successfully created

jobId
string
required

Unique identifier of the job posting generated by Collective.

Example:

"cm71yqftr00000ck0bpz3hpg1"

internalJobId
string | null
required

Your job identifier, provided at creation, or null when not set.

Example:

"CLIENT-123"

jobUrl
string<uri>
required

Public URL of the job on Collective, in the form https://www.collective.work/jobs/<language>/<slug>.

Example:

"https://www.collective.work/jobs/en/full-stack-developer-paris-8rnv"

accountEmail
string<email>
required

Email of the recruiter who owns the job posting

Example:

"recruiter@example.com"

status
enum<string>
required

OPEN, PAUSED, or CLOSED. The list endpoint defaults to OPEN; use its status parameter to select other statuses. Expiration does not change the status; check isExpired.

Available options:
OPEN,
CLOSED,
PAUSED
Example:

"OPEN"

isExpired
boolean
required

Whether the expiration date is set and has passed. Expiry does not change the status.

Example:

false

expirationDate
string<date-time> | null
required

Expiration date of the job posting

Example:

"2026-11-30T22:00:00.000Z"

closedAt
string<date-time> | null
required

Date the job was closed, or null if it has not been closed.

Example:

null

createdAt
string<date-time>
required

Date the job was created

Example:

"2026-10-22T09:30:00.000Z"

title
string
required

Job title

Example:

"Full Stack Developer"

companyName
string | null
required

Name of the company

Example:

"Collective"

companyLogoUrl
string | null
required

URL of the company logo

Example:

"https://assets.collective.work/logos/collective.png"

budget
string | null
required

Daily rate or salary range for the position, or null when not set.

Example:

"600-750€/day"

isSalaryAccordingToProfile
boolean
required

Whether the salary is determined based on the candidate profile

Example:

false

contractType
enum<string>
required

The contract type for the job

Available options:
FREELANCE,
PERMANENT_CONTRACT
Example:

"FREELANCE"

location
string | null
required

Job location, as its full English name

Example:

"Paris, France"

workPreferences
enum<string>[]
required

Work arrangements accepted for the job. Responses return an array; creation and update accept a single string.

Available options:
REMOTE,
HYBRID,
ON_SITE
Example:
skills
string[]
required

Required skills for the position

Example:
language
string | null
required

Language of the job posting, such as en, fr, or es, or null when not set.

Example:

"en"

description
string | null
required

Job description (text or sanitized HTML)

Example:

"<p>We are looking for a full stack developer.</p>"

profileWanted
string | null
required

Description of the ideal candidate profile (text or sanitized HTML)

Example:

"<p>5 years of experience with TypeScript.</p>"

questions
string[]
required

Questions for applicants, in display order

Example:
requirePhoneNumber
boolean
required

Whether phone number is required for application

Example:

false

notifyByEmailForEveryApplication
boolean
required

Whether the recruiter who posted the job is notified by email for every application

Example:

false