.svg?fit=max&auto=format&n=vy0mukkT7J4oGoAc&q=85&s=309fd13aafaa2459ab88bae66ee69fdb)
.svg?fit=max&auto=format&n=vy0mukkT7J4oGoAc&q=85&s=d463f8e401c13f13ee15256db8c610dd)
Proposals
Start Proposal Conversation
Open (or reuse) the pre-hire direct-message thread with a candidate. Employer-first; idempotent.
POST
Opens the pre-hire direct-message thread for one of your proposals so you can talk to the candidate before hiring. Idempotent: if the thread already exists, you get the same
No body.
conversationId back with created: false. Once you have the ID, send with POST /messages and read with GET /messages.
Proposal conversations are employer-first: only the job owner can open the thread, and the candidate cannot reply until the employer has sent the first message. This endpoint never creates any other kind of conversation — job threads come from hiring.
Requirements: messages:write scope + the public_api_messaging_writes feature + a claimed account (unclaimed accounts get 403 with details.reason: "account_claim_required" and a claimUrl). The proposal must be on a job you own.
Request
string
required
The proposal whose thread to open.
Response
boolean
true on success.string
The conversation to use with the messages endpoints.
string
The proposal ID.
string
The job the proposal belongs to.
boolean
true when a new thread was created, false when an existing one was returned.