Create a campaign

post

https://api.directiq.com/v2/campaigns

Creates a regular campaign and schedules it: at send_at, or right away when it is left out.
Every list, segment, contact tag and template must belong to the account, and the sender must be confirmed.

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

The body of POST /v2/campaigns, which creates and schedules a regular campaign.

name

string

required

length between 1 and 100

tags

array of strings | null

Campaign tag names; tags the account does not have yet are created.

tags

from

object

required

recipients

object

required

Who receives the campaign: at least one list, segment or contact tag, minus the exclusions.

content

object

required

language

string

required

length ≥ 1

Language of the unsubscribe footer, e.g. "en".

send_at

date-time | null

When to send, with its offset (e.g. 2026-11-03T09:00:00+01:00); the offset sets the campaign's time zone.
Leave it out to send now.

settings

object

Headers

accept

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json