Skip to main content
POST
Create job offer

Authorizations

Authorization
string
header
required

Authenticate with a Bearer token: API key, OAuth token, or session token.

Body

application/json
job_id
string<uuid>
required

Job UUID this offer belongs to.

candidate_id
string<uuid>
required

Candidate record UUID (the person on this job). Must belong to job_id.

job_offer_status_id
string<uuid> | null

Offer status UUID from GET /v1/job-offers/statuses. Omitted uses the first status by display order. Pass null for no status.

extended_date
string | null

When the offer was extended (ISO 8601 date or timestamp). Must not be after accepted_date or candidate_start_date.

accepted_date
string | null

When the candidate accepted (ISO 8601 date or timestamp). Must not be before extended_date or after candidate_start_date.

candidate_start_date
string | null

Anticipated start date (ISO 8601 date or timestamp). Must not be before extended_date or accepted_date.

compensation_currency
string | null

ISO 4217 currency code. Defaults to USD on create when omitted.

compensation_base
number | null

Base salary offered.

compensation_bonus
number | null

Bonus offered: a cash amount or a percentage of base, per bonus_type.

bonus_type
enum<string> | null

Whether compensation_bonus is a fixed amount or a percent of base.

Available options:
fixed,
percent
annual_equity_grant_percent
number | null

Annual equity grant, as a percent.

annual_equity_grant_amount
number | null

Annual equity grant amount.

initial_equity_grant_percent
number | null

Initial equity grant, as a percent.

initial_equity_grant_amount
number | null

Initial equity grant amount.

relocation_bonus
number | null

Relocation bonus amount.

sign_on_bonus
number | null

One-time sign-on bonus amount.

total_estimated_compensation
number | null

Total estimated compensation.

note
string | null

Offer notes.

owner_ids
string<uuid>[]

Team member UUIDs credited on the offer. Empty or omitted means none. Does not default to the caller.

client_contact_ids
string<uuid>[]

Client contact UUIDs to attach. Each contact must already be on the job. Empty or omitted means none. Unlike the app, contacts on the job are not auto-attached.

Response

Job offer created

success
enum<boolean>
required
Available options:
true
data
object
required