Skip to main content
POST
Create Reddit campaign

Authorizations

Authorization
string
header
required

A workspace API key.

Headers

idempotency-key
string
required

Required. Your stable id for this attempt; reuse it after a timeout to receive the same result instead of starting duplicate work.

Required string length: 1 - 200
Example:

"run-2026-08-12-0001"

Body

application/json
name
string
required

Human-readable campaign name.

Required string length: 1 - 120
connectedAccountId
string
required

Id of a connected Reddit account in this workspace. Connect and select the account in the dashboard before using this endpoint.

Required string length: 1 - 200
objective
string
required

What the campaign should achieve, written in plain language.

Required string length: 1 - 2000
keywords
string[]
required

One to 25 topics or phrases used to find relevant conversations.

Required array length: 1 - 25 elements
Required string length: 1 - 80
schedule
object
required

When the campaign may run.

brandBrainId
string | null

Optional saved Voice profile id. Omit or send null to use the Brand Foundation and Brand context.

Required string length: 1 - 200
offerUrl
string<uri>

Real landing-page URL for disclosed promotional links. Omit when there is no offer.

negativeKeywords
string[]

Topics or phrases the campaign must avoid.

Maximum array length: 25
Required string length: 1 - 80
caps
object
autoReplyOurPosts
boolean
default:false

Allow automatic replies only to comments on your own campaign posts. Defaults to false.

quietHours
object

Additional local-time window during which no action is taken.

alertEmail
string<email> | null

Email address for campaign alerts. Null disables email alerts.

Pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

Response

Success.

success
boolean
required
campaign
object
required
agent
object
required
{key}
any