Permissions:

Product tier: Available to all subscription tiers

When sending emails from Greenhouse Recruiting, organizations can choose one of two messaging services:

  • Mailgun, a third-party service
  • Custom SMTP, which allows you to send emails via your own organization's architecture

Note: Custom SMTP must be enabled for your organization by Greenhouse Support. Submit a ticket to open a support request. 

When using custom SMTP, your internal IT team is required to troubleshoot any email-related issues, and the Greenhouse Technical Support team will not be able to help diagnose errors or issues that occur after the email has been triggered from Greenhouse Recruiting.

Custom SMTP overview

Screenshot of traditional email flow

When using custom SMTP, Greenhouse Recruiting will send all emails to one of our SMTP servers, which are then relayed to your organization's mail server. The relay allows us to guarantee that all of our SMTP messages originate from one of a set of known IP addresses. You will need to allowlist each of the IP addresses and accept all messages sent by these machines.

Screenshot of custom SMTP email flow

For a custom SMTP configuration, Greenhouse Recruiting requires you to provide:

  • Host name of the server
  • Port number
  • Optional: Username of the server (not the credentials of an individual user's mailbox)
  • Optional: Password of the server (not the credentials of an individual user's mailbox)

Additionally, your organization will need to allowlist a set of IP addresses that we provide. Click here for the list of IP addresses that will need to be allowlisted for full functionality.

Configure, test, and update your custom SMTP configuration

After Custom SMTP is enabled for your organization, Site Admins can finish setup on the Configure page. (Configure > Email Settings)

First, add the domain for your email service. After it's been added, click Edit SMTP Settings and follow the steps to complete your configuration and test the connection.

To set up a new domain, you'll need the following information: 

  • Host name of the server
  • Port number
  • Username of the server (not the credentials of an individual user's mailbox)
  • Optional: Password of the server (not the credentials of an individual user's mailbox)

After setup is complete, you can use this page to update your custom SMTP configuration if any changes are needed in the future. 

Additional resources

For more information regarding custom SMTP, reach out to Greenhouse Technical Support.