Documentation
Post to your connected social accounts (X, Instagram, and more) by (platform, handle).
The Social API is organization-scoped: a post is published on behalf of your org's connected account, not a specific bot — so the canonical credential is an account token. Create one under Settings → Account Tokens (it looks like nrn_acc_…). Bot API keys (nrn_…) still work for backward compatibility, but they are legacy for this API; new integrations should use an account token.
Every request
Authorization: Bearer nrn_acc_YOUR_TOKENConnect accounts with the Neuron browser extension, which captures the session and saves it under a handle you choose (e.g. brandmain). You address the account by that handle in every call. X and Instagram post today; Facebook, LinkedIn and TikTok are official-OAuth only.
POST /api/v1/social/post publishes synchronously and returns the post id (and a URL when derivable). Provide platform (x / ig / fb / linkedin / tiktok — aliases accepted), handle, and text and/or media[].
Post text to X
curl -X POST https://api.neuron.ng/api/v1/social/post \
-H "Authorization: Bearer nrn_acc_YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"platform":"x","handle":"brandmain","text":"gm"}'GET /api/v1/social/channels lists your connected accounts (safe fields, no credentials). POST /api/v1/social/validate checks a (platform, handle) can post before you rely on it. The Social API requires a paid plan (Daily, Pro, or Business).