---
title: "Suggest a subject line"
description: "A short subject for the body of an email."
url: "https://openemail.uk/docs/api/emails/subject"
area: "API"
category: "Emails"
---

# Suggest a subject line

A short subject for the body of an email.

`POST /emails/subject`

## POST /emails/subject

A short subject for the body of an email.

## Example

Needs `emails:send`. `message` is the body, as text or HTML. The subject comes back under 100 characters, in the style of the mail you send.

**curl**

```
curl -X POST "$OE/emails/subject" -H "$AUTH" -H "Content-Type: application/json" \
  -d '{ "message": "Thanks for the signed contract. Could you send the invoice by Friday?" }'
```

**Response**

```
{ "object": "subject_suggestion", "subject": "Signed contract and invoice by Friday" }
```

> Nothing is saved, and each call spends one AI action.

## Reference

- [`POST /emails/subject`](https://openemail.uk/docs/api/reference/emails#post-emails-subject): full reference