Email candidate

Sends an email to a candidate from their opportunity.

POST https://cotlet.dev/api/v1/lever/opportunities/{opportunity_id}/emails

write Confirm

Sends one email to the candidate and returns the address and time. Lever moves an opportunity in New Lead to Reached Out when you email it, and the response shows the stage after the send. A sent email cannot be recalled. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: send_email
NameTypeDescription
opportunity_id string required string Opportunity ID from list_opportunities.
subject string required string Email subject.
body string required string Email text.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/lever/opportunities/opportunity_8c41d2/emails \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subject":"subject","body":"body"}'
Python
result = client.call("lever", "send_email", {"opportunity_id":"opportunity_8c41d2","subject":"subject","body":"body"})
Node.js
const result = await cotlet.call('lever', 'send_email', {"opportunity_id":"opportunity_8c41d2","subject":"subject","body":"body"});
CLI
cotlet call lever send_email --data '{"opportunity_id":"opportunity_8c41d2","subject":"subject","body":"body"}'

Example response

JSON

{
  "opportunity_id": "3a7c1e58-d9b2-4f60-8e41-c5d0a2b6f937",
  "to": "tom.becker@example.com",
  "subject": "Quick follow-up on Senior Designer",
  "sent_at": "2026-10-22T09:30:00Z",
  "stage_after": "Reached out"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.