# Sending Emails

## Overview

Kognitos simplifies email automation. With just a few lines of natural language syntax, you can send emails directly within your automated workflows — no configuration or server management is required.

## Behavior

By default, Kognitos sends emails using the sender **Kognitos Automation**. The sender address follows the format **`<id>@app.kognitos.com`**, where the `id` corresponds to the ID of your Playground or Process run.

<details>

<summary><em>Find Your Playground or Process ID</em></summary>

The ID is visible in the URL:

**Playgrounds**

```
kognitos.com/department/<AGENT-ID>/playground/<PLAYGROUND-ID>
```

**Processes**

```
kognitos.com/department/<AGENT-ID>/processes/<PROCESS-ID>/run/<RUN-ID>
```

</details>

{% hint style="info" %}
Alternatively, you can add the [**Microsoft Outlook Book**](https://docs.kognitos.com/legacy/legacy-experience/books/reference/outlook) to your agent to connect to your Outlook account and send emails from your own domain.
{% endhint %}

## Syntax

Below is a line-by-line overview of the automation syntax. Expand each line to learn more.

<details>

<summary><code>send an email</code> <em>or</em> <code>send an email to {recipient}</code> <em>or</em> <code>send {message} to {recipient}</code></summary>

**What does it do?**

Instructs the system to send an email from Kognitos.

**Where does it go?**

This phrase should be written on a **new line**.

**Is it required?**

✅ Yes — This phrase is **required**.

**Does it require data?**

✅ Yes — *if* specified in the syntax:

* Replace **{message}** with a **Text** value or reference.
* Replace **{recipient}** with a **Text** value or reference.

See [**Example 1**](#examples) for more details.

</details>

<details>

<summary><code>the subject is s</code></summary>

**What does it do?**

Specifies the email subject line.

**Where does it go?**

Indented beneath one of the following:

* `send an email where`
* `send an email to {recipient} where`
* `send {message} to {recipient} where`

**Is it required?**

❌ No — This phrase is **optional** in the syntax.

{% hint style="warning" %}
If no subject is specified, the default subject line is “**Message for \<recipient>**”.
{% endhint %}

**Does it require data?**

✅ Yes — Replace **s** with an email subject line.

**Example**

```
the subject is "IMPORTANT: Memo"
```

</details>

<details>

<summary><code>the message is m</code></summary>

**What does it do?**

Specifies the email message.

**Where does it go?**

Indented beneath one of the following:

* `send an email where`
* `send an email to {recipient} where`

**Is it required?**

❌ No — This phrase is **optional** in the syntax.

**Does it require data?**

✅ Yes — Replace **m** with an email message.

**Example**

```
the message is "Please take a look at the provided chart."
```

</details>

<details>

<summary><code>the attachments {is/are} x</code></summary>

**What does it do?**

Specifies the email attachments.

**Where does it go?**

Indented beneath one of the following:

* `send an email where`
* `send an email to {recipient} where`
* `send {message} to {recipient} where`

**Is it required?**

❌ No — This phrase is **optional** in the syntax.

**Does it require data?**

✅ Yes — Replace **x** with one or more references to data objects. Use **is** to specify a singular attachment or use **and** to specify multiple attachments.

**Example**

```
the attachment is the table
```

```
the attachments are the invoice, the user summary, the document
```

</details>

<details>

<summary><code>the recipients {is/are} x</code></summary>

**What does it do?**

Specifies the email recipient to whom the message will be delivered.

**Where does it go?**

Indented beneath `send an email where` .

**Is it required?**

❌ No — This phrase is **optional** in the syntax.

**Does it require data?**

✅ Yes — Replace **x** with an email recipient. Use **is** to specify a singular recipient or use **and** to specify multiple recipients.

**Example**

```
the recipients are "user@kognitos.com"
```

</details>

<details>

<summary><code>the cc emails are x</code></summary>

**What does it do?**

Specifies the recipients who will receive a carbon copy (CC) of the email.

**Where does it go?**

Indented beneath one of the following:

* `send an email where`
* `send an email to {recipient} where`
* `send {message} to {recipient} where`

**Is it required?**

❌ No — This phrase is **optional** in the syntax.

**Does it require data?**

✅ Yes — Replace **x** with one or more email recipients.

**Example**

```
the cc emails are "user@kognitos.com"
```

</details>

<details>

<summary><code>the bcc emails are x</code></summary>

**What does it do?**

Specifies the recipients who will receive a blind carbon copy (BCC) of the email.

**Where does it go?**

Indented beneath one of the following:

* `send an email where`
* `send an email to {recipient} where`
* `send {message} to {recipient} where`

**Is it required?**

❌ No — This phrase is **optional** in the syntax.

**Does it require data?**

✅ Yes — Replace **x** with one or more email recipients.

**Example**

```
the bcc emails are "user@kognitos.com"
```

</details>

## Examples

### 1. Basic Syntax

The following syntax formats are all supported equivalents and produce the same results.

{% tabs %}
{% tab title="1A. send an email" %}
**Syntax: `send an email`**

```
send an email where
    the recipient is "user@kognitos.com"
    the subject is "Kognitos: Welcome Aboard"
    the message is "We're happy to have you here! Let's automate!"
```

{% endtab %}

{% tab title="1B. send an email to {recipient}" %}
**Syntax: `send an email to {recipient}`**

```
send an email to "user@kognitos.com" where
    the subject is "Kognitos: Welcome Aboard"
    the message is "We're happy to have you here! Let's automate!"
```

{% endtab %}

{% tab title="1C. send {message} to {recipient}" %}
**Syntax: `send {message} to {recipient}`**

```
send "We're happy to have you here! Let's automate!" to "user@kognitos.com" where
        the subject is "Kognitos: Welcome Aboard"
```

{% endtab %}
{% endtabs %}

<details>

<summary>📧 <em>Kognitos: Welcome Aboard</em></summary>

We're happy to have you here! Let's automate!

</details>

### 2. Sending Emails with Attachments

#### Single Attachments

```
send an email to "user@kognitos.com" where
    the subject is "Invoice Summary"
    the message is "Attached below is the invoice summary for July 2025."
    the attachment is the invoice
```

<details>

<summary>📧 <em>Invoice Summary</em></summary>

Attached below is the invoice summary for July 2025.

📎 *Attachments: 1 file*

</details>

```
create a sample table
use the above as the table
send "Here is your table" to "user@kognitos.com" where
    the attachment is the table
```

<details>

<summary>📧 <em>Message for user@kognitos.com</em></summary>

Here is your table

📎 *Attachments: 1 file*

</details>

#### Multiple Attachments

```
send an email to "user@kognitos.com" where
    the subject is "Onboarding Materials"
    the message is "Here are your onboarding materials!"
    the attachments are the new hire paperwork, the onboarding document, the file
```

<details>

<summary>📧 <em>Onboarding Materials</em></summary>

Here are your onboarding materials!\
\
📎 *Attachments: 3 files*

</details>

### 3. Sending Multiple Messages

When multiple messages are specified, Kognitos sends a single email containing all of them:

```
the instructions are "Log into Kognitos", "Build your automation in the Playground"
send the instructions to "user@kognitos.com"
```

<details>

<summary>📧 <em>Message for user@kognitos.com</em></summary>

**instructions:**

* Log into Kognitos
* Build your automation in the Playground

</details>

### 4. Specifying CC and BBC on Emails

```
send "Hello!" to "user@kognitos.com" where
    the cc emails are "bob@kognitos.com", "amy@kognitos.com"
    the bcc emails are "madison@kognitos.com"
```

<details>

<summary>📧 <em>Message for user@kognitos.com</em></summary>

***cc:** <bob@kognitos.com>, <amy@kognitos.com>*\
\&#xNAN;***bcc:** <madison@kognitos.com>*

Hello!

</details>

## Demo

{% embed url="<https://www.youtube.com/watch?v=b4mmu0OtW9k>" %}
