# Emails

## Send

`client.emails.send(EmailSendParamsbody?, RequestOptionsoptions?): EmailSendResponse`

**post** `/v1/email`

Send emails

### Parameters

- **body:** `EmailSendParams`

  - **attachments:** `Array<Attachment>`

    A list of attachments to add to the email

    - **content:** `string`

    - **filename:** `string`

    - **contentId:** `string`

    - **disposition:** `string`

    - **type:** `string`

  - **bcc:** `string | EmailNameAndAddress | Array<string | EmailNameAndAddress>`

    A single email or list of emails for one of the address fields

    - `string`

    - `EmailNameAndAddress`
      An email address and name

      - **email:** `string`

      - **name:** `string`

    - `Array<string | EmailNameAndAddress>`

  - **cc:** `string | EmailNameAndAddress | Array<string | EmailNameAndAddress>`

    A single email or list of emails for one of the address fields

    - `string`

    - `EmailNameAndAddress`
      An email address and name

      - **email:** `string`

      - **name:** `string`

    - `Array<string | EmailNameAndAddress>`

  - **from:** `string | EmailNameAndAddress`

    An email address and name

    - `string`

    - `EmailNameAndAddress`
      An email address and name

      - **email:** `string`

      - **name:** `string`

  - **headers:** `Record<string, string>`

    A set of headers to include the email that you send

  - **html:** `string`

    HTML content of the email. Can be specified alongside text

  - **replyToList:** `EmailNameAndAddress | Array<EmailList>`

    A reply-to list of email addresses

    - `EmailNameAndAddress`
      An email address and name

      - **email:** `string`

      - **name:** `string`

    - `Array<EmailList>`

  - **subject:** `string`

    The subject line of the email

  - **text:** `string`

    Text content of the email, for email clients that may not support HTML

  - **to:** `string | EmailNameAndAddress | Array<string | EmailNameAndAddress>`

    A single email or list of emails for one of the address fields

    - `string`

    - `EmailNameAndAddress`
      An email address and name

      - **email:** `string`

      - **name:** `string`

    - `Array<string | EmailNameAndAddress>`

### Returns

- `EmailSendResponse`
  Successfully sent email

  - **message:** `string`

### Example

```node
import ValTown from '@valtown/sdk';

const client = new ValTown({
  bearerToken: 'My Bearer Token',
});

const response = await client.emails.send({
  html: 'Hello <strong>world</strong>',
  subject: 'An important message',
  text: 'Hello world',
});

console.log(response.message);
```