Skip to main content
POST
Create an Engage feed

Authorizations

Authorization
string
header
required

A SuperX API key ("sxk_..."), created in the SuperX app under Account > API / MCP / CLI. Keys are server-side secrets.

Body

application/json
name
string
required

Feed name shown in SuperX.

Required string length: 1 - 40
type
enum<string>
required

Must match the source fields sent below.

Available options:
keywords,
x_list,
list
keywords
string[]

For type keywords. Trimmed, de-duplicated case-insensitively.

Required array length: 1 - 5 elements
Maximum string length: 100
x_list_id
string

For type x_list. A numeric X list id. Use this OR x_list_url.

x_list_url
string

For type x_list. A link like https://x.com/i/lists/1234567890.

list_id
string

For type list. A contact list id from GET /v1/contact-lists.

account_id
string

Any account you own, meaning your main account (the default when omitted) or one linked to it. An account shared with you returns 403 writes_main_account_only.

Response

The created feed. active is false unless the account had no active feed.

data
object