# SendEmail - Advanced Documentation

## Model Shape (CorrespondenceInfo)

Body is required.
From is required, but the server always overwrites it with the authenticated user regardless of what is sent.
Display defaults to Value when not provided.

## When to Use

**Send an email that is not tied to any claim or contact.** Designed for headless/script use cases - e.g., an AI chatbot sending a notification email to staff. The correspondence is not persisted to the database; it is fire-and-forget.

If you need to send an email associated with a claim or contact (and have it saved as a correspondence record), use `SendCorrespondenceEmail` instead.

## Key Behavior

- **No claims or contacts allowed.** If `Claims` or `Contacts` arrays are populated, the endpoint throws `RadoloException`.
- **No persistence.** The correspondence is sent but not saved to the database. There will be no correspondence record to reference later.
- **Action is always Create.** The endpoint hardcodes the action - callers do not specify it.
- **ProcessID required.** Used for background process status tracking (`Controllers.ProcessStatus`).

## Script Example

```javascript
async () => {
  const correspondence = {
    Subject: "Case assignment notification",
    Body: "<p>You have been assigned to a new case. Please review at your earliest convenience.</p>",
    From: {
      Value: "notifications@yourfirm.com",
      Name: "Firm Notifications"
    },
    Tos: [
      {
        Value: "attorney@yourfirm.com",
        Name: "John Smith"
      }
    ]
  };

  const result = await SecureApi.SendEmail("process-1", correspondence);
  return {
    status: result.Status,
    subject: result.Subject
  };
}
```

## Cross-References

| Need | Use Instead |
|------|-------------|
| Email tied to a claim/contact (persisted) | `SendCorrespondenceEmail(ProcessID, Action, Correspondence)` |
| SMS without claim/contact | `SendSms(ProcessID, Correspondence)` |
| SMS tied to a claim/contact (persisted) | `SendCorrespondenceSms(ProcessID, Action, Correspondence)` |