> ## Documentation Index > Fetch the complete documentation index at: https://apidoc.mailercloud.com/llms.txt > Use this file to discover all available pages before exploring further. # Create Campaign (v2) > **The newer version of Create Campaign with additional options — prefer this endpoint for new integrations.** **Required:** `name`, `subject`, and `sender` (with `sender_name` + `sender_email`). **Content:** provide `html` or `plain_text`. **Audience:** provide at least one of `list_ids`, `segments`, or `tag_ids`. ## OpenAPI ````yaml /openapi-v1.json post /campaign/save openapi: 3.1.0 info: title: Mailercloud Marketing API version: 1.0.0 description: >- Campaigns, contacts, lists, segments, automations, and webhooks for the Mailercloud Marketing Platform. servers: - url: https://cloudapi.mailercloud.com/v1 security: - apiKey: [] tags: - name: Campaigns - name: Contacts - name: Lists - name: Tags - name: Segments - name: Custom Properties - name: Senders - name: Templates - name: Automations - name: Webhooks - name: Webforms - name: Inbox Tracker - name: Account paths: /campaign/save: post: tags: - Campaigns summary: Create Campaign (v2) description: >- **The newer version of Create Campaign with additional options — prefer this endpoint for new integrations.** **Required:** `name`, `subject`, and `sender` (with `sender_name` + `sender_email`). **Content:** provide `html` or `plain_text`. **Audience:** provide at least one of `list_ids`, `segments`, or `tag_ids`. operationId: create-campaign-v2 parameters: - name: Content-Type in: header required: true description: Request body type schema: type: string default: application/json requestBody: required: true content: application/json: schema: type: object properties: email_preheader: type: string exclude_list_ids: type: array items: type: string exclude_segments: type: array items: type: string exclude_tag_ids: type: array items: type: string frequency_cap: type: string html: type: string is_publish: type: string enum: - '0' - '1' description: >- `"1"` publishes/schedules the campaign; `"0"` saves it as a draft. list_ids: type: array items: type: string mailing_preference: type: boolean name: type: string maxLength: 150 minLength: 1 pause_rules: type: object properties: pause_condition: type: string enum: - greater than - less than pause_criteria: type: string enum: - open - click pause_limit: type: integer minimum: 1 maximum: 50 pause_target: type: integer minimum: 1 maximum: 100 wait_time: type: integer minimum: 1 maximum: 43200 description: >- Minutes to wait before evaluating pause rules (max 30 days). permission_reminder: type: string plain_text: type: string reply_email: type: string reply_id: type: string report_spam: type: boolean rules: type: object properties: contacts_order: type: string enum: - first - last limit: type: integer scheduled_at: type: string description: >- Schedule time in `YYYY-MM-DD HH:MM:SS` format. Omit to send according to `is_publish`. segments: type: array items: type: string sender: type: object properties: sender_email: type: string format: email sender_name: type: string maxLength: 100 required: - sender_name - sender_email sender_id: type: array items: type: string subject: type: string maxLength: 65000 minLength: 1 tag_id: type: string tag_ids: type: array items: type: string tag_name: type: string x-examples: Example 1: email_preheader: string exclude_list_ids: - string exclude_segments: - string exclude_tag_ids: - string frequency_cap: string html: string is_publish: string list_ids: - string mailing_preference: true name: string pause_rules: pause_condition: string pause_criteria: string pause_limit: 0 pause_target: 0 wait_time: 0 permission_reminder: string plain_text: string reply_email: string reply_id: string report_spam: true rules: contacts_order: string limit: 0 scheduled_at: string segments: - string sender: sender_email: string sender_name: string sender_id: - string subject: string tag_id: string tag_ids: - string tag_name: string required: - name - subject - sender examples: example-1: value: email_preheader: 'Prime member: You have an unused Prime benefit' exclude_list_ids: - '123' - '456' exclude_segments: - segment1 - segment2 exclude_tag_ids: - tag1 - tag2 frequency_cap: daily html: Sample HTML is_publish: '1' list_ids: - sCVJ - ghy mailing_preference: true name: Campaign name pause_rules: pause_condition: greater than pause_criteria: open pause_limit: 1 pause_target: 1 wait_time: 10 permission_reminder: >- If you wish to opt out of all types of emails, click Unsubscribe. plain_text: Plain text content reply_email: sender@yourdomain.com reply_id: reply-id-1 report_spam: false rules: contacts_order: last limit: 5 scheduled_at: '2021-04-17 15:48:00' segments: - hju sender: sender_email: sender@yourdomain.com sender_name: Sender Name sender_id: - sender-123 subject: Prime member notification. tag_id: prime-tag tag_ids: - tag-123 - tag-456 tag_name: Prime Campaign Tag example-2: value: email_preheader: Your weekly newsletter is here! exclude_list_ids: - exclude-list-1 exclude_segments: - exclude-segment-1 exclude_tag_ids: - exclude-tag-1 frequency_cap: weekly html: Weekly newsletter content is_publish: '0' list_ids: - list1 - list2 mailing_preference: false name: Weekly Newsletter pause_rules: pause_condition: less than pause_criteria: click pause_limit: 3 pause_target: 2 wait_time: 20 permission_reminder: >- You are receiving this email because you subscribed to our newsletter. plain_text: Plain text newsletter content reply_email: newsletter@yourdomain.com reply_id: reply-id-2 report_spam: true rules: contacts_order: first limit: 10 scheduled_at: '2022-01-10 10:00:00' segments: - segment1 - segment2 sender: sender_email: newsletter@yourdomain.com sender_name: MailerCloud Team sender_id: - sender-456 subject: Weekly Newsletter tag_id: newsletter-tag tag_ids: - tag-789 - tag-101 tag_name: Newsletter Tag responses: '201': description: |- { "id": "a" } content: application/json: schema: type: object properties: id: type: string description: ID of the created campaign. examples: created: value: id: aBc12 '400': description: Bad Request content: application/json: schema: description: '' type: object properties: error: type: object properties: field: type: string minLength: 1 message: type: string minLength: 1 errors: type: array items: type: object properties: field: type: string message: type: string examples: example-1: value: errors: - field: sender_email message: sender_email must be a valid email address - field: reply_email message: reply_email must be a valid email address '401': description: Unauthorized content: application/json: schema: description: '' type: object properties: error: type: object properties: field: type: string minLength: 1 message: type: string minLength: 1 errors: type: array items: type: object properties: field: type: string message: type: string examples: example-1: value: errors: - field: '' message: Authorization failed servers: - url: https://cloudapi.mailercloud.com/v2 components: securitySchemes: apiKey: type: apiKey in: header name: Authorization description: >- Your Mailercloud API key (plain text, no Bearer prefix). Create keys in Settings → API. ````