Create a job

The ID of an existing company. Required unless you supply company — exactly one of the two must be present, and supplying both is an error.

Long-form description of the role, as HTML. Up to 25,000 characters. The HTML is sanitized on write: tags and attributes outside the supported formatting set (paragraphs, headings, lists, links, inline emphasis) are removed. Plain text without HTML tags is converted to paragraphs.

URL-friendly slug for the job. Auto-generated from title when omitted.

Employment type of the role. When customEmploymentType is also sent, this must be the Google equivalent of that custom type (or be omitted: the server sets it). Sending a built-in type without customEmploymentType clears any custom type on the job.

Key of one of the board's custom employment types (GET /v1/settings/job-form → employmentType.customTypes). The job is saved with the Google equivalent of that type as its built-in employmentType, which is what Google for Jobs and feeds see. An unknown key, a type the board no longer offers (offered: false), or an employmentType that differs from its Google equivalent returns 400 jobs_constraint_violation. Pass null to clear the custom type and keep the built-in; omitted means unchanged.

Required. Whether the role is on-site, hybrid, or fully remote: one of on_site, hybrid, remote. Omitting it or sending null returns 400. It is not valid on its own either: on_site and hybrid require at least one officeLocations entry, and remote requires remotePermits (use [{"type":"worldwide","value":"worldwide"}] for anywhere; remoteTimezones then auto-derives on POST).

Whether the employer sponsors visas for remote candidates. One of yes, no, or unknown.

Seniority level of the role.

Where candidates apply. Accepts an HTTPS URL, a mailto: URI, or a bare email address (which is normalized to mailto: form).

Minimum salary, in salaryCurrency units. null means not set. When salaryMin or salaryMax is set, salaryCurrency and salaryTimeframe are both required; otherwise 400.

Maximum salary, in salaryCurrency units. null means not set. When salaryMin or salaryMax is set, salaryCurrency and salaryTimeframe are both required; otherwise 400.

Three-letter ISO 4217 currency code for salaryMin and salaryMax. null means not set. Required when salaryMin or salaryMax is set; optional otherwise.

Period the salaryMin and salaryMax figures are quoted against. null means not set. Required when salaryMin or salaryMax is set; optional otherwise.

Whether the job appears in featured slots on the public board.

Time at which the job was first published, as a Unix epoch in milliseconds. When omitted on create with status: "published", the server stamps the current time. Useful for bulk-importing historical jobs while preserving original publication dates. PATCH may overwrite an existing value but cannot clear it.

Minimum required experience, expressed in months.

If true, equivalent experience may substitute for the listed education requirements.

Period denominator for inOfficeFrequency.

How often the candidate must be in-office over inOfficePeriod.

An external identifier for the job from your own system, such as an ATS requisition ID. Use this value to look up the job later via GET /v1/jobs?externalId=... for deduplication. Always set it on create (the source job URL or ATS requisition ID) so reposts of the same job are detected reliably, even when several jobs share one applicationUrl. Scoped per-account: two different accounts may reuse the same externalId without collision. Up to 255 characters. null means not set.

The job title.

Initial status of the job. Defaults to draft. Only draft and published are writable here. The system-set values expired, archived, and pending_approval are not. Use the dedicated transitions (POST /v1/jobs/:id/publish, /pause, /expire) for status changes after create.

Set to true to create this job even though another job on your account already uses the same applicationUrl (for example, several roles that share one ATS page or one application inbox). Only skips the application-URL duplicate check; a matching externalId or an identical job (same company, title, location and description) still returns 409 jobs_already_exists. Defaults to false.

Unique identifier for the object. Use this value as the {id} path parameter for the job endpoints (e.g. GET /v1/jobs/{id}).

String representing the object's type. Objects of the same type share the same value.

The job title.

URL-friendly slug used in public board URLs, or null if no slug is set.

Current status of the job. One of draft, published, expired, archived, or pending_approval. A pending_approval job is waiting for an operator to approve it: approve with POST /v1/jobs/:id/publish, reject with DELETE /v1/jobs/:id. It is not public, like a draft.

Identifier of the company the job belongs to, or null if no company is attached.

Employment type of the role, or null if not specified. For a job with a custom employment type, this is the Google equivalent of the custom type.

Whether the role is on-site, hybrid, or fully remote. null only on older jobs saved without one; create requires it and PATCH cannot clear it.

Seniority level of the role, or null if not specified.

Minimum salary in salaryCurrency units, or null if not specified.

Maximum salary in salaryCurrency units, or null if not specified.

Three-letter ISO 4217 currency code for the salary range, or null if no salary is specified.

Period the salary range is quoted against, or null if no salary is specified.

Whether the job appears in featured slots on the public board.

Time at which the job was first published, or null if not yet published. ISO 8601 datetime.

Time at which the job expires as an ISO 8601 datetime. null can appear when the expiry requirement does not apply, including for drafts and sponsored jobs; ordinary published jobs always have an expiry.

Time at which the job was created. ISO 8601 datetime.

Time at which the job was last updated. ISO 8601 datetime.

Monotonic Job lifecycle revision used to reconcile webhook events. Legacy rows are 0 until the rollout backfill runs.

External identifier supplied by the caller on create, used for deduplication via GET /v1/jobs?externalId=.... null when no external identifier was set.

Long-form description of the role (HTML), or null if not specified.

Where candidates apply, or null if not specified. An HTTPS URL or mailto: URI.

Read-only: derived from remotePermits. true only when the authored selection is a single {type:"worldwide"} entry.

Whether the employer sponsors visas for remote candidates. One of yes, no, or unknown.

Minimum required experience in months, or null if not specified.

If true, equivalent experience may substitute for the listed education requirements. null if not specified.

Period denominator for inOfficeFrequency, or null if not specified.

How often the candidate must be in-office over inOfficePeriod, or null if not specified.