---
title: "Create a newsletter"
method: POST
path: "/v1/chat/newsletters"
tags: ["newsletters"]
---

# Create a newsletter

`POST /v1/chat/newsletters`

Create a newsletter.

## Request body

- CreateNewsletterRequest
  - `name` string, required — The name of the newsletter.
  - `query` string, required — The natural language query to run for the newsletter.
  - `cron` string, required — The cron schedule for the newsletter. For example daily at 00:00 UTC is '0 0 * * *'. See https://crontab.run/ for more examples
  - `model` 'gpt-4o' | 'gpt-4o-mini' | 'claude-3-5-sonnet-latest' | 'meta-llama/Meta-Llama-3.1-405B-Instruct' | 'meta-llama/Meta-Llama-3.3-70B-Instruct', required — The model to use for the newsletter.
  - `subject` string, nullable — The subject of the newsletter. If not provided it will be auto generated.
  - `sender` string, required — The sender of the newsletter.
  - `logo_url` string, uri, nullable — The logo URL for the newsletter.
  - `reply_to` string, nullable — The reply-to address for the newsletter. If not provided, the sender will be used.
  - `audience_id` string, nullable — The audience ID to use for the newsletter. If not provided a new audience will be created.
  - `resend_api_key` string, nullable — The resend API key to use for the newsletter. If not provided, the newsletter will not be sent.
  - `public` boolean — Whether the newsletter is public or not. If not provided, the newsletter will be public. If you make the newsletter public only title and query will be shown.
  - `active` boolean — Whether the newsletter is active or not. If not provided, the newsletter will be active. If you make the newsletter inactive, it will not be sent.
  - `expires_at` string, date-time, nullable — The expiration date for the alert. Default is None. If set, the alert will be disabled after this date.

## Response `201`

Created newsletter.

- NewsletterResponse
  - `id` string, uuid, required
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `user_id` string, uuid, required
  - `alert_id` string, uuid, nullable
  - `name` string, required
  - `query` string, required
  - `cron` string, required
  - `model` string, nullable, required
  - `subject` string, nullable, required
  - `sender` string, required
  - `logo_url` string, nullable, required
  - `reply_to` string, nullable, required
  - `audience_id` string, nullable, required
  - `resend_api_key` string, nullable, required
  - `public` boolean
  - `active` boolean
  - `expires_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/asknews/apis/asknews-api.md) · [All operations](https://skmtc.dev/asknews/apis/asknews-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/asknews/asknews-api/revisions/dd4286769887/schema)