Send offer letter
Generate the offer letter, email it to the candidate and optionally request an e-signature.
POST https://cotlet.dev/api/v1/ashby/offers/{offer_id}/letter
write Confirm
Runs Generate Offer Letter, drafts the email from the template and sends it, as View Offer does in Ashby. If your organization uses approvals, the call is refused until every approval step is complete. An e-signature request is added only if the letter template has candidate e-signature tokens and you set request_signature. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| offer_id string required | string | Offer ID from create_offer or get_candidate. |
| email_template string required | string | Email template from list_email_templates. |
| request_signature boolean | boolean | Also send the e-signature request. Default: false. |
| signatory string | string | Company signatory email, when the template has company tokens. |
Request
curl -X POST https://cotlet.dev/api/v1/ashby/offers/offer_8c41d2/letter \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email_template":"jane@example.com"}'result = client.call("ashby", "send_offer_letter", {"offer_id":"offer_8c41d2","email_template":"jane@example.com"})const result = await cotlet.call('ashby', 'send_offer_letter', {"offer_id":"offer_8c41d2","email_template":"jane@example.com"});cotlet call ashby send_offer_letter --data '{"offer_id":"offer_8c41d2","email_template":"jane@example.com"}'Example response
{
"offer_id": "6b3e90d4-1f87-4a52-8c06-d94a7e215b03",
"letter_generated": true,
"email_template": "Offer letter",
"email_status": "sent",
"signature_requested": true
}