---
title: "create a mailing. 🔓"
method: POST
path: "/v3/mailings"
tags: ["mailings"]
---

# create a mailing. 🔓

`POST /v3/mailings`

create a new mailing<br/> <br/> <strong>Example Post Data:</strong><br/> <code> {<br/> &nbsp;&nbsp;&nbsp;&nbsp;"name":&nbsp;"my internal name",<br/> &nbsp;&nbsp;&nbsp;&nbsp;"subject":&nbsp;"subject line",<br/> &nbsp;&nbsp;&nbsp;&nbsp;"sender_name":&nbsp;"Bruce Wayne (Wayne corp.)",<br/> &nbsp;&nbsp;&nbsp;&nbsp;"sender_email":&nbsp;"bruce.wayne@gotham.com",<br/> &nbsp;&nbsp;&nbsp;&nbsp;"content":&nbsp;{<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"html/text",&nbsp;&nbsp;//&nbsp;"html", "text" or "html/text"<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"html":&nbsp;"&lt;html&gt;&lt;body&gt;The two faces of Harvey Dent&lt;/body&gt;&lt;/html&gt;",<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"text":&nbsp;"The two faces of Harvey Dent"<br/> &nbsp;&nbsp;&nbsp;&nbsp;},<br/> &nbsp;&nbsp;&nbsp;&nbsp;"receivers":&nbsp;{&nbsp;&nbsp;//&nbsp;fill either a list of group ids or a filter id<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"groups":&nbsp;[&nbsp;"31939",&nbsp;"81942"&nbsp;],<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"filter":&nbsp;"66"<br/> &nbsp;&nbsp;&nbsp;&nbsp;},<br/> &nbsp;&nbsp;&nbsp;&nbsp;"settings":&nbsp;{<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"editor": "wizard",&nbsp;&nbsp;//&nbsp;"wizard", "freeform", "advanced", "plaintext"<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"open_tracking": true,&nbsp;&nbsp;//&nbsp;track opening of emails<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"click_tracking": true,&nbsp;&nbsp;//&nbsp;track clicks of emails<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link_tracking_url": "27.wayne.cleverreach.com",<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"link_tracking_type": "google",&nbsp;&nbsp;//&nbsp;"google", "intelliad", "crconnect"<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"google_campaign_name": "My Campaign",&nbsp;&nbsp;//&nbsp;in case of link_tracking_type == "google"<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"unsubscribe_form_id": "23",<br/> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"category_id": "54"<br/> &nbsp;&nbsp;&nbsp;&nbsp;}<br/> } </code><br/> <br/> <strong>Note:</strong> For links not to be substituted by tracking links, use 'single quotes' around urls in your html. <br/>

## Request body

- CreatemailingModel
  - `name` string, required — internal name of the mailing
  - `subject` string, required — subject of the mail
  - `sender_name` string, required — name of the sender
  - `sender_email` string, required — sender email
  - `content` object — definition object for mail content (see example)
  - `receivers` object — definition object for receivers (see example)
  - `settings` object — definition object for settings (see example)
  - `tags` string[] — tags for the mail

## Response `200`

Success

- boolean

---

[API](https://skmtc.net/cleverreach/apis/cleverreach-rest-api.md) · [All operations](https://skmtc.net/cleverreach/apis/cleverreach-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cleverreach/cleverreach-rest-api/revisions/b05c9b904be4/schema)