Create Campaign

Creates a campaign — the Create Campaign action on the admin Marketing → Communications → Campaigns screen.

TIP

New here? Read the Campaigns overview for what a campaign does and how its fields behave.

Endpoint

Endpoint	Method
/api/admin/marketing/campaigns	POST

Details

• Requires an admin Bearer token and the marketing.communications.campaigns.create permission.
• Returns the full campaign payload, including the resolved channel, customerGroup, marketingTemplate, and marketingEvent objects (marketingEvent is null when no event is linked).
• Creating a campaign does not send it — use the send endpoint to queue the email.

Request body

Field	Type	Required	Notes
name	string	yes	Campaign name
subject	string	yes	Email subject line
marketing_template_id	int	yes	Email template to send
channel_id	int	yes	Channel the campaign sends from
customer_group_id	int	yes	Customer group the campaign targets
marketing_event_id	int	no	Linked event, or null
status	int	no	0 inactive / 1 active