# 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**](/legacy/legacy-experience/books/reference/outlook.md) 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>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kognitos.com/legacy/legacy-experience/writing-automations/sending-emails.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
