Package Information
Documentation
n8n-nodes-promptui
PromptUI's n8n community node — publish to X, Facebook, Instagram, TikTok, and LinkedIn from any n8n workflow, and trigger workflows when PromptUI events fire.
Features
- Publish action — post to X, Facebook, Instagram, TikTok, or LinkedIn via your connected PromptUI account.
- Webhook trigger — run a workflow when
publishedorgeneratedevents fire. Signature-verified (HMAC SHA-256). - Auto-registered webhook — activating a trigger registers a webhook in PromptUI; deactivating deletes it.
- Platform API key auth —
pui_xxxkeys generated from the PromptUI dashboard.
Installation
Current distribution status:
n8n-nodes-promptuiis not yet published to npm.- Until npm publication lands, install from a local checkout using the development workflow below.
- After npm publication, self-hosted n8n operators will be able to install it through Settings → Community Nodes or with
npm install n8n-nodes-promptui. - Unverified community nodes aren't available on n8n Cloud.
Reviewer readiness
See REVIEWER_READINESS.md for the external review checklist, live Settings artifact proof, and the current blockers for npm publication and n8n verification.
See SUBMISSION_CHECKLIST.md for the concrete publication, self-hosted smoke, and Creator Portal submission runbook.
Credentials
Create a PromptUI API credential in n8n:
| Field | Value |
|---|---|
| API Key | Your pui_... key (PromptUI dashboard → Settings → API Keys) |
| Base URL | https://www.promptui.co (default) |
Nodes
PromptUI (action)
| Operation | Platforms |
|---|---|
| Publish | X · Facebook · Instagram · TikTok · LinkedIn |
Each platform exposes only the fields its endpoint accepts. Errors from the underlying /api/publish/* routes are surfaced as NodeApiError so n8n's retry/continue-on-fail semantics apply.
PromptUI Trigger
| Event | Fires when… |
|---|---|
| published | /api/publish/* successfully posts to a platform |
| generated | GTM content generation completes |
Every incoming webhook is verified against the X-PromptUI-Signature HMAC header. Requests with a bad or missing signature return 401.
Supported platforms
| Platform | Endpoint | Required parameters |
|---|---|---|
| X | POST /api/publish/x |
text |
POST /api/publish/facebook |
pageId, message |
|
POST /api/publish/instagram |
igUserId, caption, imageUrls |
|
| TikTok | POST /api/publish/tiktok |
body |
POST /api/publish/linkedin |
text |
Development
cd packages/n8n-nodes-promptui
npm install
npm run build
Link into a local n8n install for testing:
npm link
cd ~/.n8n/custom
npm link n8n-nodes-promptui
License
MIT © PromptUI