Skip to main content

​
Overview

Firstwork integrates with SendGrid for all email delivery — from application confirmations and stage notifications to onboarding welcome emails and compliance reminders.

​
Setup

1

Get your SendGrid API key

  1. Log in to your SendGrid account
  2. Navigate to Settings > API Keys
  3. Create a new API key with Mail Send permissions
2

Configure in Firstwork

Go to Settings > Integrations > Email in the Firstwork dashboard and enter your SendGrid API key.
3

Verify sender

Ensure your sending email address is verified in SendGrid:
  • Single sender verification for testing
  • Domain authentication for production

​
Email Templates

Firstwork uses Company Notification Templates for email content:
Template ComponentDescription
SubjectEmail subject line (supports variables)
BodyHTML email body (supports variables)
SenderFrom address and name
Reply-ToReply-to address

​
Template Variables

Templates support Object Graph variables for dynamic content: 
Hello {{application.candidate.first_name}},

Your application for {{application.hiring_flow.name}} has been 
advanced to the {{application.current_stage.name}} stage.

Best regards,
{{company.name}}

​
Email Actions in Automations

The Send Email action is available in automations:
ConfigurationDescription
TemplateWhich notification template to use
RecipientDynamic recipient (candidate, admin, custom)
CC / BCCAdditional recipients
AttachmentsDynamic file attachments
DelayOptional send delay

​
Common Email Automations

  • Application confirmation on submission
  • Stage transition notifications
  • Document request reminders
  • Offer letter delivery
  • Onboarding welcome emails
  • Training assignment notifications
  • Check-in form reminders

​
Delivery Tracking

Firstwork tracks email delivery status:
  • Sent
  • Delivered
  • Opened (when tracking enabled)
  • Bounced
  • Failed
Failed deliveries are logged in the automation execution history for debugging.