Skip to main content
Sending offers in the app? See Offers and Emails.
create_self_schedule_link does not send email. create_offer does: it is the offer itself. Template tokens fill in when the template is applied, not at send: in the app when a person picks a template in the composer. A token typed into subject or body yourself goes out as written.

​
Send an offer

create_offer sends the company’s Offer email through Hotfix, from your company’s address on Hotfix and as you, with the same letter attached as a PDF. Send subject and body to write the letter yourself. pay, start_date, and respond_by (YYYY-MM-DD) fill the letter’s {{pay}}, {{start_date}}, and {{respond_by}}; each is required only when the letter uses it. One open offer at a time. Over HTTP, signature: true also sends the PDF through SignWell for the candidate to sign and you to countersign, when get_offer says signing is true. preview_offer returns the PDF without sending. The candidate accepts by replying. get_offer returns the latest offer, with reply once the candidate’s reply is on the offer’s thread. offer is null when there is none.

​
Record the answer

mark_offer records it:
  • accepted moves them to Hired. from_reply keeps their reply as the acceptance; over HTTP, file attaches a signed copy from any signing tool.
  • declined moves them back to Interviewing. It never un-hires.
A SignWell signature marks the offer accepted by itself, with the signed copy at offer_pdf (signed=true). To take an offer back, email the candidate and mark it declined. There is no offer page, link, or expiry: the respond-by date is text in the letter.