Create Offer

Create a prefilled DRAFT offer for a candidate on a position. positionId and profileId are required; applicationId is optional -- when omitted, the candidate's latest application to the position is linked. The candidate must already have an application to the position; if they have none the request is rejected (advance the candidate into the position's pipeline first via the application-stages API). Field values are set in a separate PATCH /offers/ call (two-step create, mirroring the UI create -> intake-form flow). Returns the full created offer. If an offer already exists for the candidate+position, that existing offer is returned.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
boolean

Whether to prefill candidate, position and compensation data on the new offer. Defaults to true.

Body Params
int32
required

job id. Accepts an integer or a numeric string.

int32 | null

application id to link the offer to. If omitted, the candidate's latest application to the position is used.

string
required

unique identifier for profile. Accepts the numeric profile id as a string or an encoded profile id; resolved to the numeric id OfferSchema returns as profileId.

Headers
string
required

The secret key to access the api. It starts with the bearer token

Response

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json