Configure inbound email processing

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

CiviCRM can automatically process incoming email messages and create new contacts from them. To do this, you must configure CiviCRM with the details of at least one email account that it should check periodically for this purpose. When you first sign in to CiviCRM, you will be prompted for this configuration.

  • Configure the inbound mail account using the information below as a guideline. This example configures a Gmail account. Replace USERNAME and PASSWORD with your Gmail account username and password respectively.

      Server -
      Username -
      Password - PASSWORD
      Email domain - the email address domain
      Protocol - POP3
      Used for? - choose "Bounce Processing" to use this account for bounced messages, or "Email-to-Activity Processing" to use it as a source of new contacts

    CiviCRM inbound email configuration

  • Click “Save” to save your changes.

  • Once you have configured the details of the inbound email account(s), visit the “Scheduled Jobs” section of the administration console and enable the “Process Inbound Emails” and “Fetch Bounces” jobs to begin automatic processing of inbound emails.

    [![CiviCRM jobs](/images/img/apps/civicrm/civicrm-jobs.png)](/images/img/apps/civicrm/civicrm-jobs.png)

For more information, refer to the CiviCRM documentation.

Last modification April 8, 2020