> For the complete documentation index, see [llms.txt](https://docs.udara360.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.udara360.io/udara360-docs-1/operations/send-email.md).

# Send Email

To send an email, make a <mark style="color:yellow;">`POST`</mark> request to this endpoint, passing the recipient list (`tos`), optional CC/BCC recipients, a `subject`, and the `body` of the email in the request body.

A successful request returns a status confirming the operation succeeded.

This process allows you to send email notifications to one or more recipients; for example, `transaction alerts`, `statements`, or `account notifications`.

<mark style="color:yellow;">`POST`</mark>` ``/api/Operations/v1/SendEm`ail

**Headers**

| Name                                                | Value              | Description                                 |
| --------------------------------------------------- | ------------------ | ------------------------------------------- |
| Content-Type<mark style="color:red;">\*</mark>      | `application/json` | Format of the request payload               |
| request-reference<mark style="color:red;">\*</mark> | `unique_string`    | A unique reference identifying this request |

**Body Parameters**

<table><thead><tr><th>Name</th><th width="157">Data Type</th><th data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>tos</code></td><td>array of strings</td><td>true</td><td>List of recipient email addresses</td></tr><tr><td><code>ccs</code></td><td>array of strings</td><td>false</td><td>List of CC (carbon copy) recipient email addresses</td></tr><tr><td><code>bccs</code></td><td>array of strings</td><td>false</td><td>List of BCC (blind carbon copy) recipient email addresses</td></tr><tr><td><code>subject</code></td><td>string</td><td>true</td><td>Subject line of the email</td></tr><tr><td><code>body</code></td><td>string</td><td>true</td><td>Body content of the email</td></tr></tbody></table>

**Body table**

| Field     | Data Type | Description                             |
| --------- | --------- | --------------------------------------- |
| `status`  | boolean   | Whether the email was sent successfully |
| `message` | string    | Response message from the operation     |

Here is an example request and response with a sample payload sent to the endpoint in Curl format.

<details>

<summary>Sample Request</summary>

```json
curl --location -g '{{baseurl}}/api/Operations/v1/SendEmail' \
--header 'Content-Type: application/json' \
--header 'request-reference: unique_string' \
--data-raw '{
  "tos": [
    "gbolahanlao@gmail.com"
  ],
  "ccs": [
    ""
  ],
  "bccs": [
    ""
  ],
  "subject": "Testing",
  "body": "Testing"
}'
```

</details>

<details>

<summary>Response : <code>200</code></summary>

```
{
  "status": true,
  "message": "Operation Successful"
}
```

</details>
