# Email reader

> Add contacts by sending an email that Amazeful reads and extracts details from.

Source: https://support.amazeful.com/contacts/adding-contacts/email-reader
Documentation index: https://support.amazeful.com/llms.txt

Our email reader has two options:

* Contact extract
* Attached file (coming soon)

### Sending emails

To send an email to us for extraction, you can include the provided email address in the following fields:

* To
* Cc
* Bcc

### Contact extract

Contact extract will read contact information from the body content of the email.

All key-value pairs must be stored in square brackets separated by a colon.

*Example usage:*

\[first\_name: John]

\[last\_name: Smith]

\[email: <johnsmith@example.com>]

| Key                                                                                                                                                  | Value                              |
| ---------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| <p><mark class="docs-badge docs-badge-red">REQUIRED</mark></p><p>first\_name</p>                                                                         | The contact's first name.          |
| <p><mark class="docs-badge docs-badge-blue">OPTIONAL</mark></p><p>last\_name</p>                                                                         | The contact's last name.           |
| <p><mark class="docs-badge docs-badge-red">REQUIRED</mark> <mark class="docs-badge docs-badge-blue">(optional when phone is present)</mark></p><p>email</p>  | The contact's email address.       |
| <p><mark class="docs-badge docs-badge-red">REQUIRED</mark> <mark class="docs-badge docs-badge-blue">(optional when email is present)</mark></p><p>phone </p> | The contact's mobile phone number. |

#### Aliases

Aliases allow you to replace the keys used by the platform with more visibly friendly alternatives.

When using a key whose value is 2 or more keys, the platform will break on the space character.

*For example:*

* \[Name: John Smith] = (*first\_name = John) + (last\_name = Smith)*
* \[Name: John Roger Smith] = (*first\_name = John) + (last\_name = Roger Smith)*

*Example usage:*

\[Name: John Smith]

\[Email: <johnsmith@example.com>]

| Key                  | Parent key               |
| -------------------- | ------------------------ |
| First name, Business | *first\_name*            |
| Last name, Surname   | *last\_name*             |
| Email                | *email*                  |
| Phone, Mobile        | *phone*                  |
| Name                 | *first\_name last\_name* |

#### Considerations

* If you have the same key and/or a corresponding alias key, then only the first value will be taken. To avoid unwanted outcomes, please ensure each key is included only once.