# Emails

Your app will not use Bubble’s native “send email” functionality, but instead use our own sendGrid API workflow that generates a nicely-formatted HTML email from the system.

To start using this feature, please set up your SendGrid email by following [this step in our Quickstart Guide](https://docs.airdev.co/canvas/quickstart-guide#step-2-setting-up-your-email).

![send\_email API workflow in Canvas: App Foundation template](https://3252195253-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-La2JFb_HHpm-nbVNHOC%2F-LaH1gcY8AMXehrPkpX0%2F-LaH2X1UriZlr9Osk7Mj%2Fassets_-LYJWnUT3lUFQk1K9BCK_-L_iVFOOzjrt_liAx8my_-L_iIqsmVjSiIzYpC9pk_Screen%20Shot%202019-03-11%20at%2012.51.17%20PM.png?alt=media\&token=02a11c6e-6e9c-4f27-b0b9-a2022206cde1)

To send a nicely-formatted HTML email, go to the `Workflows` tab > select `Custom Events` >  Select `Schedule API workflow` > select `send_email` from the API workflow dropdown and set the scheduled date to `Current date/time`. 

![](https://3252195253-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-La2JFb_HHpm-nbVNHOC%2F-LaH1gcY8AMXehrPkpX0%2F-LaH2b_6V_skwAQ9Tb8l%2Fassets_-LYJWnUT3lUFQk1K9BCK_-L_iVFOOzjrt_liAx8my_-L_iNhU_Xv6GU0WXYGJJ_Screen%20Shot%202019-03-11%20at%201.03.58%20PM.png?alt=media\&token=2198c02e-6f52-4821-bb32-1723834344a2)

Fill out the email content in the additional fields.

* **from\_name (required)** - Sender's name to display
* **from\_email (required)** - Sender's email
* **reply\_to\_email (optional)** - Sender's alternative email (if reply to email is different from from\_email)
* **to\_emails (required)** - Receiver's email (can be a comma separated list)
* **cc\_emails (optional)** - Carbon copy emails (can be a comma separated list)
* **bcc\_emails (optional)** - Blind carbon copy emails (can be a comma separated list)
* **subject (required)** - Email title / subject
* **body (required)** - Write `<br>` for a line break (since the parameter is a single line). Dynamic text (e.g., from a multiline input) will handle line breaks automatically.
  * Image in the body: `<img src='https:image’s url’ width=‘518’/>`
  * Link in the body:  *`<a href="link url">Words to be hyperlinked</a>`*
* **button\_text (optional)** - By default, there will be no button added to the email. However, if this field isn't empty, an action button will be added.
* **button\_link (optional)** - The link which the button is linked to
* **attachment (optional)** - If this is used, the file will be sent along with the email
* **button\_color (automatically populated)** - This is added from the field `Primary Color` on the Website object
* **signature (automatically populated)** - By default this will be `The [app name] team` but you can add a different text in this field to override it
* **logo** - By default, this is added from the field `Logo light` on the `Website` object, but you can also add a different logo in the API workflow parameter to override it.