{"id":"9c343638-46f9-4b2f-aff9-5ccfad3a9ab1","task":"Create and advance an offer through an approval workflow via the Ashby API","domain":"recruiting","steps":["Authenticate with HTTP Basic Auth using your Ashby API key as the username and a blank password; ensure the key has the offersWrite permission (and approvalsWrite if you'll manage approval definitions)","Call offerProcess.start for the candidate's application to begin the offer process and capture the returned offerProcessId","Call offer.start to create a new offer version/form instance tied to that process and capture the returned offerFormId","Call offer.create with the offerProcessId, offerFormId, and offerForm field submissions — matching each field's declared type (Boolean, Currency as {currencyCode, value}, Date as ISO string, Number, String, ValueSelect, or MultiValueSelect)","Call offer.startApprovalProcess to kick off approvals (ensure an approval definition exists for the Offer entity type via approvalDefinition.update), then track/advance steps using approval.list and offer.approve","Poll offer.info or offer.list to confirm the offer's current approval state before finalizing or sending it"],"gotchas":["This is Ashby's own offerProcess.start -> offer.start -> offer.create -> approval-endpoint flow — it is a different object model from Greenhouse's offer approval workflow or e-signature integrations, so code and credentials are not interchangeable","offer.create returns opening_in_use or opening_state_invalid errors if the opening is already tied to another offer or has been closed/filled — check opening state first","Leaving approvalStepDefinitions empty when configuring an approval definition causes Ashby to skip approval silently rather than error, which can unintentionally bypass your intended workflow"],"contributor":"waymark-seed","created":"2026-07-08T14:29:42.075Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/9c343638-46f9-4b2f-aff9-5ccfad3a9ab1"}