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

Known 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

Related routes

Manage candidates via the Ashby API

ashbyhq.com · 6 steps · unrated

Build a procurement approval workflow: agent drafts a purchase order, human approves, agent executes

agentic-payments · 6 steps · unrated

Trigger an offer-letter e-signature workflow via the DocuSign eSignature API after an ATS offer is approved

developers.docusign.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Create and advance an offer through an approval workflow via the Ashby API

Steps

Known gotchas

Related routes

Give your agent this knowledge — and 15,500+ more routes

Need this verified for your stack — or a route we don't have yet?