Skip to Content



The General build page is where you configure the following:

To open the General build page, go to Configuration > General:

General page


The SMTP panel is where you configure a custom SMTP server (for one type of email—see below):

SMTP panel

There are three types of email App Builder or an app can send:

  • Bulk emails: An app user can send selected records to other (registered) app users using the Send Email button.

    The SMTP settings for this type of email are defined in the app user's UI, on the Administration > Email Accounts page.

  • System emails: At different times in an app's lifecycle, App Builder sends these system emails:

    Recipient Event
    App administrator First time you publish an app
    App user New account creation
    App user Password reset
    App user App access granted

    Emails of this type always use App Builder's built-in SMTP server. (To have system emails sent from a custom SMTP server, contact Jitterbit Support.)

  • Flow emails: If an app has a microflow with a Send Email step, emails are automatically sent to the app users defined in the step.

    With an empty SMTP configuration, emails of this type use the built-in SMTP server. If you define a custom SMTP server, only flow emails use it; system emails continue to be sent via the built-in SMTP server.

The following table summarizes the source of SMTP configuration for each type of email:

Email type Built-in SMTP
(App Developer's UI)
Custom SMTP
(App Developer's UI)
Custom SMTP
(App User's UI)
System Contact Jitterbit Support

Custom SMTP Server

To define a custom SMTP server, follow these steps:

  1. In the SMTP panel, set values for the following:

    • Host: Enter the SMTP server's hostname.

    • Port: Enter the SMTP server's port number (usually one of 25, 465, 587, or 2525).

    • User: Enter the username used to access the SMTP server.

    • Password: Enter the password for User.

    • Secure Connection (SSL): Set On to enable SSL.

    • Senders: The email's sender addresses (as seen in a sent email's From field). You must add at least one before you can save the settings.

  2. Click Save.

To return to using the built-in SMTP server, click Delete. (This action affects both support-enabled custom SMTP system emails and flow emails.)


If you have no need for custom SMTP settings, you can contact Jitterbit Support to hide the SMTP panel.

Add a Sender

To add a sender, follow these steps:

  1. In the Senders section of the SMTP panel, click the icon. The Sender Add dialog opens.

  2. Enter values for these fields:

    • Name: Enter the name for the sender.

    • Email: Enter a valid email address for the sender.

    • Default: Set On to make this sender the default.

  3. Click Add to add the sender, or Cancel to cancel.

To edit a sender, follow these steps:

  1. In the Senders section of the SMTP panel, click the icon for a sender. The Sender Modify dialog opens.

  2. Edit the values, then click Add to save, or Cancel to cancel.


When there is only one sender, it is set to Default by default.

To delete a sender, follow these steps:

  1. In the Senders section of the SMTP panel, click the Delete icon for a sender.

  2. The sender is deleted. (There is no confirmation.)


When there is only one sender, it is the default and cannot be deleted.

Google Maps API Key

A Google Maps API key is defined in the Google Maps API Key panel on the General build page:

Google Maps API Key Configuration

To define a key for a Location field, follow these steps:

  1. Create a Google Cloud Platform (GCP) project in your GCP Console, and enable the Maps Javascript API, Maps Static API, and Places API.

  2. In the Your API Key field on the Google Maps API Key panel, enter your Google Maps API key.

  3. Click Save.

  4. Publish your app. (Location fields do not work in an app preview.)


Remind your app's users that their browser's privacy settings must allow the app to ask for their location.