Create Campaign

Create a draft campaign.

MethodPOST

/api/v2/campaigns

Request Examples

import { Lumail } from "lumail";

const lumail = new Lumail({ apiKey: process.env.LUMAIL_API_KEY });
const { data, error } = await lumail.campaigns.create({
  name: "Launch",
  subject: "Hello",
});
if (error) {
  throw error;
}
console.log(data.id);

Response Examples

{
  "id": "cmp_abc123",
  "name": "Launch",
  "subject": "Hello",
  "preview": null,
  "status": "DRAFT",
  "contentType": "MAILY",
  "senderId": "snd_abc123",
  "replyTo": null,
  "createdAt": "2026-09-05T10:30:00.000Z"
}

Creates a draft campaign. Permission: campaigns.

Omitted content gets a default template with an unsubscribe link. Omitted senderId uses the default sender, then last used, then any available sender.

Body Parameters

Name	Type	Description
`subject`	string	Required. Email subject line.
`name`	string	Campaign name. Default `Untitled`. Max 100.
`preview`	string or null	Preview / preheader text.
`content`	unknown	TipTap JSON (object or string). Default includes an unsubscribe link.
`contentType`	`"MAILY"` \| `"PLATE"` \| `"MARKDOWN"`	Content format. Default `MAILY`.
`senderId`	string	Email sender id. Defaults to the org default sender.
`replyTo`	string or null	Reply-To address.

Response Fields

Field	Type	Description
`id`	string	Campaign id.
`name`	string	Campaign name.
`subject`	string	Subject line.
`preview`	string or null	Preview text.
`status`	string	Always `DRAFT` on create.
`contentType`	string	`MAILY`, `PLATE`, or `MARKDOWN`.
`senderId`	string	Assigned sender id.
`replyTo`	string or null	Reply-To address.
`createdAt`	string	ISO 8601 created timestamp.

Errors

Status	`name`	When
401	`missing_api_key`	Missing or invalid bearer token
403	`missing_permission`	Token lacks the `campaigns` permission
422	`validation_error`	Missing subject or invalid payload

PreviousList Campaigns NextGet Campaign

Body Parameters

Response Fields

Errors

Related