> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thepurplebox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Send email

> Send emails with a single API call.

### Headers

<ParamField header="Content-Type" type="string">
  `application/json`
</ParamField>

### Body

<ParamField body="from" placeholder="hello@thepurplebox.io" type="string" required>
  Your verified sender email address.

  Using `username <email>` format is also supported.
</ParamField>

<ParamField body="to" placeholder="hello@recipient.com" type="string[]" required>
  A single email address or an array of email addresses.
</ParamField>

<ParamField body="subject" placeholder="Hello!" type="string" required>
  The subject of the email.
</ParamField>

<ParamField body="body" placeholder="Your first email" type="string" required>
  The body of the email.
</ParamField>

<ParamField body="cc" placeholder="cc@recipient.com" type="string[]">
  Carbon copy recipients. A single email address or an array of email addresses.
</ParamField>

<ParamField body="bcc" placeholder="bcc@recipient.com" type="string[]">
  Blind carbon copy recipients. A single email address or an array of email addresses.
</ParamField>

<ParamField body="username" placeholder="Company name" type="string">
  Optional: The name to display as the sender.
</ParamField>

<ParamField body="reply_to" placeholder="hello@thepurplebox.io" type="string">
  Override the reply\_to address. Defaults to the from address or your verified email if the from address is not set.
</ParamField>

<ParamField body="headers" type="object">
  Additional headers to include in the email.
</ParamField>

<ParamField body="attachments" type="array">
  Up to 5 file attachments
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates whether the call was successful.
</ResponseField>

<ResponseField name="emails" type="Email Object">
  <Expandable title="properties">
    <ResponseField name="message" type="string">
      The SMTP server response.
    </ResponseField>

    <ResponseField name="email_id" type="string">
      The ID of the email.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="timestamp" type="datetime">
  The timestamp of the event.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": [
      {
        "message": "250 OK queued as 12345",
        "email_id": "12345"
      },
    ],
    "timestamp": "1970-01-01T00:00:00.000Z"
  }
  ```
</ResponseExample>