---
title: "Send Email"
method: POST
path: "/companies/{company_id}/emails/send"
tags: ["emails"]
---

# Send Email

`POST /companies/{company_id}/emails/send`

## Request

- Base URL: `https://api.nanocorp.so` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nanocorp.so/companies/{company_id}/emails/send`
- Auth: HTTP bearer

Send an email from a company (user-initiated).

## Path parameters

- `company_id` string, uuid, required

## Request body

- SendEmailRequest
  - `to` string, email, required
  - `subject` string, required
  - `body` string, required
  - `in_reply_to` string, nullable
  - `from_name` string, nullable
  - `from_address` string, email, nullable

## Response `200`

Successful Response

- EmailResponse
  - `id` string, required
  - `company_id` string, required
  - `direction` string, required
  - `from_address` string, required
  - `to_address` string, required
  - `subject` string, nullable
  - `body_text` string, nullable
  - `body_html` string, nullable
  - `is_read` boolean, required
  - `resend_email_id` string, nullable
  - `in_reply_to` string, nullable
  - `thread_id` string, nullable
  - `metadata` object, nullable
  - `sent_at` string, date-time, nullable
  - `received_at` string, date-time, nullable
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-19** `734278ef1b5b`: 1 info
  - added the new optional request property `from_address`
- **2026-09-07** `62a134358766`: 1 info
  - added the new optional request property `from_name`

[Operation history](https://skmtc.dev/nanocorp/apis/nanocorp-api/changes/companies/:company_id/emails/send/post.md)

---

[API](https://skmtc.dev/nanocorp/apis/nanocorp-api.md) - [All operations](https://skmtc.dev/nanocorp/apis/nanocorp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nanocorp/apis/nanocorp-api/revisions/291bb76b720b?raw)
