Complete guide to automated candidate email communication. Covers email types, CLI usage, Python SDK, Zapier automation, and candidate experience best practices.
Automatic Candidate Follow-up Emails: Personalized Communication at Scale
Learn how to automatically generate personalized interview invitations, rejection emails, and follow-up messages based on screening results. Maintain candidate experience while eliminating manual communication work.
# Generate interview email for top candidate
hiresquire email \
--job 123 \
--candidate 456 \
--type invite \
--tone friendly
Why Automated Candidate Emails?
Automated follow-up emails solve critical hiring pain points:
- Consistent experience: Every candidate receives timely, professional communication
- Zero manual work: Eliminate hours of repetitive email writing
- Personalization: AI-generated emails tailored to each candidate's score and strengths
- Brand consistency: Maintain your company voice across all communications
- Scalability: Handle 100s of candidates without increasing headcount
Available Email Types
| Type | Use Case | Trigger (Suggested) |
|---|---|---|
invite |
Invite top candidates to interview | Score 80-100 |
keep-warm |
Keep candidate engaged for future roles | Score 60-79 |
followup |
Generic follow-up for more info | Manual / Agent Choice |
rejection |
Standard rejection email | Score < 60 |
CLI Workflow
Generate emails directly from the command line after your screening finishes:
# 1. Submit screening
hiresquire screen --title "Senior Dev" --description "..." --resumes ./resumes/ --watch
# 2. Get top candidates (score > 80)
hiresquire results --job 123 --min-score 80 --json
# 3. Generate invite for the best match
hiresquire email --job 123 --candidate 456 --type invite --tone friendly
Python SDK Integration
Automate email generation in your custom Python workflows:
from hiresquire import HireSquire
client = HireSquire("your_token")
# After screening completes
results = client.wait_for_completion(job_id)
for candidate in results["candidates"]:
# Determine email type based on score
if candidate["score"] >= 80:
email_type = "invite"
elif candidate["score"] >= 60:
email_type = "keep-warm"
else:
email_type = "rejection"
# Generate personalized email
email = client.candidates.generate_email(
job_id=job_id,
candidate_id=candidate["id"],
email_type=email_type,
tone="professional",
custom_notes=f"Your strengths in {', '.join(candidate['raw_analysis']['strengths'][:2])} stood out."
)
# Process or send the email
print(f"Subject: {email['subject']}")
print(f"Body: {email['body']}")
REST API Endpoint
With HireSquire, you can generate personalized emails directly via the API. This is perfect for integration into existing systems or low-code tools like n8n and Zapier.
Step 1: Generate an Interview Invite
Once you've identified a top candidate, use the generate-email endpoint:
# POST /api/v1/jobs/{job_id}/generate-email
{
"candidate_id": 456,
"type": "invite",
"tone": "friendly",
"custom_notes": "We loved your experience with Laravel and AWS."
}
Step 2: Keep-Warm and Follow-ups
Don't let candidates go cold while you're still reviewing others. Use the keep-warm type to stay in touch:
# POST /api/v1/jobs/{job_id}/generate-email
{
"candidate_id": 456,
"type": "keep-warm",
"tone": "professional"
}
Zapier Automation Workflow
Set up completely automated email workflows with Zapier:
Complete Automation Flow
- Trigger: HireSquire webhook when screening completes
- Action 1: Filter by candidate score (e.g. ≥80 for interviews)
- Action 2: Call HireSquire generate-email API
- Action 3: Send email via Gmail/Outlook/SendGrid
- Action 4: Log to Google Sheets or your ATS
Best Practices
Candidate Experience Guidelines
- Send rejection emails promptly - never ghost candidates
- Include specific feedback when possible (AI-generated strengths)
- Keep rejection emails concise but professional and polite
- For top candidates: send interview invites within 24-48 hours
- Always include your calendar link in interview invitations
Automated candidate emails eliminate the biggest manual pain point in hiring. With HireSquire's AI-generated messages, you can maintain a professional candidate experience while saving hours of work per hire.