Email Infrastructure for Recruiting AI Agents

import multimail

client = multimail.Client(api_key="mm_live_...")

"cm"># Agent drafts rejection — goes to approval queue, not delivered yet
result = client.send_email(
    from_mailbox="[email protected]",
    to="[email protected]",
    subject="Your application for Senior Engineer — Acme Corp",
    body="""Hi Sarah,

Thank you for taking the time to interview for the Senior Engineer role at Acme Corp.
After careful consideration, we have decided to move forward with another candidate.

We appreciate your interest and wish you well in your search.

Best,
Acme Recruiting Team""",
    oversight_mode="gated_send",
    metadata={
        "candidate_id": "cand_8821",
        "role_id": "req_4402",
        "stage": "final_rejection"
    }
)

print(f"Queued for review: {result.message_id}")
print(f"Status: {result.status}")  "cm"># 'pending_approval'

import multimail
import time
from datetime import datetime, timedelta

client = multimail.Client(api_key="mm_live_...")

def send_fcra_pre_adverse(candidate_email: str, candidate_name: str, job_title: str) -> str:
    """Step 1: Pre-adverse action notice. Must wait >=5 business days before final adverse."""
    result = client.send_email(
        from_mailbox="[email protected]",
        to=candidate_email,
        subject="Important Notice Regarding Your Employment Application",
        body=f"""Dear {candidate_name},

We are writing to inform you that information contained in a consumer report
may affect our hiring decision for the {job_title} position.

You have the right to dispute the accuracy or completeness of any information
in the report. Contact information for the consumer reporting agency is enclosed.

Please respond within 5 business days if you wish to dispute any information.

Human Resources
Acme Corp""",
        oversight_mode="gated_all",
        metadata={
            "notice_type": "fcra_pre_adverse",
            "notice_sent_at": datetime.utcnow().isoformat(),
            "final_adverse_not_before": (datetime.utcnow() + timedelta(days=7)).isoformat()
        }
    )
    return result.message_id

def send_fcra_final_adverse(candidate_email: str, candidate_name: str, pre_adverse_id: str) -> str:
    """Step 2: Final adverse action notice. Only send after waiting period elapses."""
    result = client.send_email(
        from_mailbox="[email protected]",
        to=candidate_email,
        subject="Final Notice: Employment Application Decision",
        body=f"""Dear {candidate_name},

Following our previous notice dated [date], we have made a final decision
not to extend an employment offer based in part on information in a consumer report.

You have the right to obtain a free copy of the report within 60 days and
to dispute its accuracy directly with the consumer reporting agency.

Human Resources
Acme Corp""",
        oversight_mode="gated_all",
        metadata={
            "notice_type": "fcra_final_adverse",
            "pre_adverse_message_id": pre_adverse_id
        }
    )
    return result.message_id

import multimail

client = multimail.Client(api_key="mm_live_...")

def process_candidate_replies(mailbox: str):
    inbox = client.check_inbox(mailbox=mailbox, unread_only=True)

    for email_summary in inbox.emails:
        email = client.read_email(message_id=email_summary.message_id)

        "cm"># Classify intent — your LLM call here
        intent = classify_candidate_intent(email.body)

        if intent == "offer_accepted":
            client.tag_email(
                message_id=email.message_id,
                tags=["offer-accepted", "requires-onboarding-kickoff"]
            )
            notify_onboarding_team(email)

        elif intent == "offer_declined":
            client.tag_email(
                message_id=email.message_id,
                tags=["offer-declined", "pipeline-update-needed"]
            )
            notify_recruiter(email, urgency="high")

        elif intent == "question":
            client.tag_email(
                message_id=email.message_id,
                tags=["candidate-question", "needs-response"]
            )
            "cm"># Queue for human response — agent does not reply autonomously
            create_response_task(email)

        else:
            client.tag_email(
                message_id=email.message_id,
                tags=["needs-review"]
            )

def classify_candidate_intent(body: str) -> str:
    "cm"># Your LLM classification call here
    pass

process_candidate_replies(mailbox="[email protected]")

import multimail
from typing import TypedDict

client = multimail.Client(api_key="mm_live_...")

class InterviewSlot(TypedDict):
    candidate_email: str
    candidate_name: str
    date: str
    time: str
    timezone: str
    format: str  "cm"># 'video' | 'phone' | 'onsite'
    meeting_link: str
    interviewers: list[str]

def send_interview_confirmation(slot: InterviewSlot) -> str:
    format_detail = (
        f"Video call: {slot[&"cm">#039;meeting_link']}"
        if slot[&"cm">#039;format'] == 'video'
        else f"Phone: we will call you at your registered number"
    )

    result = client.send_email(
        from_mailbox="[email protected]",
        to=slot[&"cm">#039;candidate_email'],
        subject=f"Interview Confirmed — {slot[&"cm">#039;date']} at {slot['time']} {slot['timezone']}",
        body=f"""Hi {slot[&"cm">#039;candidate_name']},

Your interview is confirmed for {slot[&"cm">#039;date']} at {slot['time']} {slot['timezone']}.

{format_detail}

Interviewers: {&"cm">#039;, '.join(slot['interviewers'])}

If you need to reschedule, reply to this email at least 24 hours in advance.

Acme Recruiting""",
        oversight_mode="monitored",
        metadata={
            "interview_date": slot[&"cm">#039;date'],
            "interview_format": slot[&"cm">#039;format']
        }
    )
    return result.message_id