Skip to content

SuperX n8n community node

Published with provenancePublished with provenancenpm holds a signed attestation linking this release to the exact source commit and CI run that built it, so you can check what you install was built from the code it claims.What provenance means

@nativeship/n8n-nodes-superx

Connect SuperX to n8n to draft, schedule, and publish X posts, review analytics, and work with audience and engagement data.

Install in n8n

Open Settings → Community Nodes → Install and paste this name.

@nativeship/n8n-nodes-superx

n8n Cloud installs only community nodes verified by n8n, so this one needs self-hosted n8n.

What you can do with SuperX in n8n

106 operations across 20 resources

Analytics

1 operation

  • Get analytics — Totals and a per-day series (posts, engagement, impressions, follower

Articles

10 operations

  • Create an article draft — Creates a draft from `content_markdown` (max 400 KB). Supports headings, lists, quotes, emphasis, links, HTTP(S) images, and standalone X post embeds. Unsupported constructs become plain text with `warnings`; non-HTTP(S) image/link URLs return 400.
  • Delete an article — Deletes the article and refunds quota if it was scheduled. Works for the main and linked accounts; shared accounts are read-only.
  • Generate an AI cover image — Generates a 2.5:1 cover from the required title and attaches it by default. `attach: false` leaves the cover unchanged. Choose `style_id` or `style_text` (max 8,000 characters), not both; unknown IDs return `404 cover_style_not_found`.
  • Get an article — Returns the article and `content_markdown`; rich-text constructs that Markdown cannot express may appear as plain text.
  • List articles — Long-form X Articles for the selected account, newest-updated first. Article bodies do NOT appear in lists; fetch one article for its markdown body.
  • List saved cover styles — The article cover styles the account saved in the SuperX app: the art
  • Publish an article to X now — Publishes the stored title, body, and cover publicly and immediately, spending post quota. Requires X Premium; X's limits of 10 drafts and 5 publishes per day can return `502 x_publish_failed`.
  • Schedule or reschedule an article — Schedules `scheduled_for` in UTC ISO 8601 with an explicit offset, over 2 minutes ahead. Draft scheduling deducts quota (refunded on unschedule/delete); rescheduling is free. Supports `Idempotency-Key`; shared accounts are read-only.
  • Unschedule an article — Moves a scheduled article back to draft and refunds its scheduling quota. Works for the main and linked accounts; shared accounts are read-only.
  • Edit an article — Updates supplied fields only. `content_markdown` replaces the full body; `cover_url` accepts an HTTP(S) image URL or `null` to remove it. Main and linked accounts are writable; shared accounts are read-only.

Audience

9 operations

  • Add a note to a contact — Write a private note about one person. The note is attributed to the
  • Delete a note on a contact — Returns 204 with no body. Deleting an already-deleted note, or a note
  • Read an audience list — A page of the account's followers, following, repliers or reposters
  • Get one contact — One person's stored profile (handle, name, bio, location, website,
  • List notes on a contact — The private notes this account has written about one person, newest
  • List one contact's replies to you — The stored reply history from one contact to the selected account, with the replied-to post when available.
  • List engaged contacts — People who engaged with the selected account over the moving 90-day window, with reply and repost tallies.
  • List replies you received — Every stored reply the selected account has received across all of its posts, with the replier's profile and the replied-to post when available.
  • Edit a note on a contact — Replace one note's body. The note must belong to the contact in the

Contact Lists

9 operations

  • Add a contact list member — Add a person to a list you created, by `handle` (live profile lookup)
  • Add contact list members in bulk — Add up to 500 people to a list you created, by numeric X user id.
  • Create a contact list — Create a list you can add people to. Names are NOT unique: the SuperX
  • Delete a contact list — Delete a list you created, and with it its membership. The people
  • List contact list members — Members of one contact list you created. Includes a 90-day
  • List contact lists — The selected account's contact lists: system lists first (Followers,
  • Remove a contact list member — Remove a member from a list you created. Returns 204 with no body.
  • Remove contact list members in bulk — Remove up to 500 members from a list you created, by member id (the
  • Rename a contact list — Rename a list you created. System lists are managed automatically and

Content

2 operations

  • List published posts — Lists posts written by the account, with optional content type, date range, and sort filters.
  • List replies you sent — Replies the selected account sent to other accounts, newest first. A

Context

7 operations

  • Remove one product — Removes one product by its numeric id (from GET /v1/context). Reversible: re-adding the same url via PATCH or PUT restores the product with its scraped details intact.
  • Get context settings — Returns the account's AI Context: profile description, interests, rules, reply guidance, favorite creators, style guide, and up to five products.
  • Rebuild the generated style guide — Rewrites the account's GENERATED style guide from its recent posts,
  • Refresh a product from its page — Re-reads a saved product's page and refreshes its stored name,
  • Replace the product list — Replaces the full product list (max 5); products omitted by URL are removed. Use PATCH `/v1/context/products/{id}` to update one product. Re-adding a URL restores its scraped details; omitted fields stay unchanged and `null` clears them.
  • Update context settings — Updates selected Context fields; omitted fields stay unchanged. `null` clears strings; arrays replace the full list (`[]` clears it). Only owners can change Context; editor-access shares return `403 editor_restricted`.
  • Add or edit one product — Updates one product by numeric ID or URL-encoded URL. URL-based requests create the product if absent (max 5). Omitted fields stay unchanged; send `null` to clear a field.

Datasets

8 operations

  • Add a dataset's people to a contact list — Copy the people in a ready dataset into a contact list you created.
  • Collect an audience into a dataset — Collect the repliers, quote posters or reposters of a post, the
  • Draft outreach messages onto a research dataset — Writes one personalized message per person in a research dataset,
  • Export a dataset as CSV — The whole dataset as a CSV file.
  • Get a dataset — One dataset's status, counts and coverage.
  • Get dataset rows — A page of a ready dataset's rows.
  • List datasets — The audience collections Ask SuperX built for the key owner in the
  • Refine a dataset by what each person wrote — Judges each row's own text against a natural-language `criterion` and

DMs

5 operations

  • Cancel a campaign's unsent messages — Deletes every message of this campaign still waiting to go out,
  • Read one DM campaign — The messages this campaign queued, with a count per status.
  • DM allowances and usage — The account's DM caps and how much of each is used. These are PLAN
  • List the DM queue — The account's bulk DM rows, newest first: what is waiting, what went
  • Queue a DM campaign — Queues direct messages to up to 100 X users.

Engage

7 operations

  • Create an Engage feed — Save a new Engage feed on the account: a set of keywords, a public X
  • Delete an Engage feed — Remove a saved feed. If it was the feed the SuperX app has open, the
  • Draft one reply to a post — Writes ONE reply draft in the account's own voice, using the same
  • Get posts from an Engage feed — Candidate posts from one saved feed, with the author profile and
  • Get mentions of the account — The posts that @-mention the selected account right now, newest first
  • List Engage feeds — The account's saved Engage feeds: the keyword and list feeds it
  • Update an Engage feed — Rename a saved feed, replace what it watches, or both. Send at most

Identity

2 operations

  • Get the key owner — Returns the key owner, their plan, the calling key's name and scopes, and the AI credit pool.
  • List your accounts — The accounts this key may act on: your main account plus any linked

Inspiration

2 operations

  • Search the inspiration library — Search a library of 50M+ real high-performing posts by topic. Use the
  • Search the inspiration media index — Search the cross-platform media index behind the SuperX app's

Media

1 operation

  • Presign an image upload — Registers an image upload and returns a presigned `upload_url`. PUT

Meta

1 operation

  • Machine-readable quickstart — A short markdown quickstart (auth header, base URL, endpoint list, rate limits). No authentication required.

Queue

2 operations

  • Get queue settings — Returns posting slots (`{ time, days }`) and timezone for the account. Weekdays use `0` for Sunday; `slot_count` counts each time/day pair. Default flags show whether SuperX supplies the value. Supports main, linked, and shared accounts.
  • Update queue settings — Updates `slots`, `timezone`, or both; omitted fields stay unchanged. `slots` replaces the full list (max 50 unique times; each slot needs a weekday, with `0` for Sunday). Send `[]` to clear predefined slots.

Scheduling

10 operations

  • Delete queued posts in bulk — Deletes up to 100 QUEUED posts at once and refunds their post quota.
  • Enable auto retweet on queued posts in bulk — Turns Auto Retweet on for up to 100 queued posts at once.
  • Retime queued posts in bulk — Moves up to 500 queued posts to new times in ONE transaction: either
  • Create a draft or scheduled post, or publish now — Creates a post: a draft when `scheduled_for` is omitted, a scheduled
  • Delete a draft or scheduled post — Deletes the post and refunds any quota it held. Works for your main account or any account linked to it (`account_id`); accounts shared with you are read-only.
  • Write post drafts in your voice — Writes post drafts from a brief, in the account's own voice. Nothing
  • List plug templates — Lists auto-plug templates created in SuperX. Pass a template ID as `auto_plug.template_id` when creating or updating a scheduled post.
  • List drafts and scheduled posts — The account's drafts and scheduled posts, most recently updated first,
  • Rewrite a post in your voice — Rewrites a post in the account's own voice, as close to or as far from
  • Edit a draft or scheduled post — Partial update: only the fields you send change; everything else on

Signals

12 operations

  • Add a signal to an agent — Add one thing for the agent to watch: a search (`keyword_watch`), an
  • Create a signal agent — Create a signal agent: it watches X for the given keywords and scores
  • Delete a signal agent — Delete an agent. The leads it already saved and its destination
  • Expand an audience description into a rubric — Turns a plain description of an audience into the structured rubric
  • Build an audience profile from a website — Reads a product or company website and infers who its ideal customers
  • List signal agents — The account's signal agents: the automated lead finders from the
  • List signal leads — The leads the account's signal agents have found, newest first:
  • Remove a signal from an agent — Remove one signal. Leads it already found stay, and so does the
  • Search for leads on X now — One live keyword search over X, scored against an ideal-customer
  • Set feedback on a lead — Record the account's verdict on one lead - `fit`, `not_fit`, or
  • Suggest keyword watches — Turns a plain description of an audience into 2 or 3 keyword-watch
  • Update a signal agent — Edit an agent's `name`, `icp_description`, `precision_mode`,

Tags

4 operations

  • Create a tag — Creates a workspace-wide tag with a unique name. `color` accepts the documented palette and defaults to `blue`. Only the main account can write tags; other account IDs return `403 writes_main_account_only`.
  • Delete a tag — Deletes the workspace-wide tag and removes it from attached drafts and scheduled posts; the posts remain. Only the main account can write tags; other account IDs return `403 writes_main_account_only`.
  • List tags — Tags organize drafts and scheduled posts. They are scoped to the workspace owner and shared across linked accounts. Sorted by name A-Z.
  • Rename or recolor a tag — Provide `name` and/or `color`. Tags are workspace-wide, so this is a main-account write and any other `account_id` returns `403 writes_main_account_only`.

Tools

5 operations

  • Check a statement against a web search — Runs a web search for the statement and reports `true`, `false` or
  • Edit one selected piece of a post — Edits the piece of a post you select, keeping the style of the text
  • Sort recent posts on topic Read, Pass or Not sure — Searches recent public posts for a topic and sorts them into three
  • Score a draft against this account's own posts — Scores ONE draft from 0 to 100 against the account's OWN recent
  • Rewrite a post one preset way — Applies one preset rewrite to a whole post.

Workers

5 operations

  • Dismiss a suggestion — Drop one Worker suggestion out of the "To review" queue. No post is
  • Save a suggestion as a draft — Turn one Worker suggestion into a DRAFT post. Nothing is posted to X:
  • List Worker suggestions — The posts the account's Workers wrote, newest first. The default
  • List Workers — The account's Workers, newest first: the scheduled AI writers set up
  • Schedule a suggestion — Turn one Worker suggestion into a SCHEDULED post. The SuperX scheduler

X Lookups

4 operations

  • Top replies to a public post — The best-liked DIRECT replies to a public post, read live from X.
  • Latest posts of a public account — One live timeline page (about 20 posts) for any public account,
  • Look up one public post live — Read one public X post as it is right now: full text (never
  • Look up one public profile live — Read one public X profile as it is right now: bio, location, link,

About SuperX

The SuperX n8n node connects SuperX to n8n for managing X (Twitter) content, analytics, and audience data. Use it to prepare posts, review performance, and work with contacts and engagement.

SuperX node selected on an n8n workflow canvas

Connect SuperX to n8n

  1. Install the @nativeship/n8n-nodes-superx community node in your n8n instance.
  2. In SuperX, create an API key from Account > API / MCP / CLI.
  3. In n8n, create a SuperX API credential, paste the key into Access Token, and select the resource and action you need.

SuperX node details in n8n showing scheduling, analytics, audience, and engagement actions

What you can do

Draft, edit, schedule, or publish X posts. You can also list published posts and retrieve post analytics.

Create and manage article drafts, schedule or publish articles, and generate article cover images.

Work with audience data by collecting and refining datasets, finding leads, managing contact lists and notes, and reviewing replies and mentions.

Use SuperX content tools to write or rewrite posts and draft replies.

Built with NativeShip

NativeShip created and maintains this SuperX node. NativeShip helps SaaS companies launch and maintain verification-ready n8n community nodes in minutes.

Want to launch an n8n node for your SaaS? Explore NativeShip.

SuperX questions

Yes. Create a draft or scheduled post, edit or reschedule it, or publish it right away.

Yes. The node can retrieve post analytics, including performance totals and daily data.

Yes. You can review replies and mentions, draft a reply, manage contacts and notes, and add or remove contact list members.

It uses a SuperX API credential. Create an API key in SuperX and enter it in the Access Token field in n8n.

Yes. NativeShip helps SaaS companies build and maintain verification-ready n8n community nodes for their products.

More Social Media nodes

All Social Media nodes

  • Post Bridge

    Published with provenancePublished with provenancenpm holds a signed attestation linking this release to the exact source commit and CI run that built it, so you can check what you install was built from the code it claims.What provenance means

    @nativeship/n8n-nodes-postbridge

    Use the Post Bridge n8n node to create and schedule social posts, check publishing results, and view analytics from your workflows." category: "Social Media

    10 downloads last week

  • Supergrow

    Published with provenancePublished with provenancenpm holds a signed attestation linking this release to the exact source commit and CI run that built it, so you can check what you install was built from the code it claims.What provenance means

    @nativeship/n8n-nodes-supergrow

    Connect Supergrow to n8n to create, schedule, and publish LinkedIn posts, track engagement, and manage content.

    10 downloads last week

  • Threads

    Published with provenancePublished with provenancenpm holds a signed attestation linking this release to the exact source commit and CI run that built it, so you can check what you install was built from the code it claims.What provenance means

    @nativeship/n8n-nodes-threads

    Use the Threads n8n node to publish text, image, video, and carousel posts, manage replies, and retrieve post or profile insights.

    6 downloads last week

Ready to launch your n8n, Make, Zapier or Activepieces integration?

Give your customers another way to use your product.

Get started