Skip to main content
POST
Add contact list members in bulk

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.

Path Parameters

id
string
required

The list id from GET /v1/contact-lists.

Body

application/json
x_user_ids
string[]
required

Numeric X user ids.

Required array length: 1 - 500 elements
account_id
string

Response

The bulk add finished. Read the counters for what happened.

data
object

Counters from a bulk member add. added + duplicates + failed equals the number of resolvable ids; not_found ids never reached the list. Members are inserted one at a time upstream, so a 502 or 503 can land after some of them were already added. Retrying the same request is safe: the list dedupes on (list, person), so anything that got in the first time comes back in duplicates rather than being added twice.