Neuron Social API
Post to connected social accounts by (platform, handle). Org-scoped — use an account token (nrn_acc_); bot API keys are accepted but legacy for this API.
Post to connected social accounts by (platform, handle). Org-scoped — use an account token (nrn_acc_); bot API keys are accepted but legacy for this API.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/neuron-ng:neuron-ng-social-api-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Neuron Social API
version: 1.0.0
description: 'API reference for Neuron — the AI-powered WhatsApp chatbot platform.
Neuron lets you build intelligent chatbots with tool integrations, knowledge bases, and human-in-the-loop monitoring.
## Authentication
Most endpoints require a JWT bearer token obtained from `POST /auth/login`.
Bot API endpoints use API keys prefixed with `nrn_`.
The **Social API** (`/social`) is organization-scoped — authenticate with an **account token** (`nrn_acc_`, from Dashboard → Settings → Account Tokens). Bot API keys are also accepted for backward compatibility but are legacy for this API.
## Response Format
All responses follow the envelope: `{ success: boolean, data?: any, error?: { message, code } }`'
servers:
- url: /api/v1
description: API v1
tags:
- name: Social API
description: Post to connected social accounts by (platform, handle). Org-scoped — use an account token (nrn_acc_); bot API keys are accepted but legacy for this API.
paths:
/social/post:
post:
tags:
- Social API
summary: Publish a post to a connected social account
description: 'Post text and/or media to a connected account addressed by (platform, handle), synchronously. Org-scoped; available on paid plans. Auth: account token (nrn_acc_) canonical, bot API key also accepted (legacy).'
security:
- AccountTokenAuth: []
- ApiKeyAuth: []
requestBody:
content:
application/json:
schema:
type: object
required:
- platform
- handle
properties:
platform:
type: string
description: x/twitter, ig/instagram, fb, linkedin, tiktok (aliases accepted)
handle:
type: string
description: the handle the account was connected under (via the Neuron extension)
method:
type: string
enum:
- session
- official
description: override the channel's default credential path
text:
type: string
description: post text (required for text-only posts)
media:
type: array
items:
type: object
required:
- url
- type
properties:
url:
type: string
type:
type: string
enum:
- image
- video
as:
type: string
enum:
- feed
- story
description: '"story" publishes exactly one image or video as an Instagram story (accounts connected with Instagram login; the caption isn''t shown, and the response''s notes say so). Default "feed".'
required: true
responses:
'201':
description: Success
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
data:
type: object
properties:
platform:
type: string
handle:
type: string
method:
type: string
enum:
- session
- official
postId:
type: string
url:
type: string
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: postSocialPost
x-operation-id-source: derived
/social/channels:
get:
tags:
- Social API
summary: List connected social accounts
description: Safe fields only (no credentials) — platform, handle, label, which paths are available.
security:
- AccountTokenAuth: []
- ApiKeyAuth: []
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
data:
type: array
items:
type: object
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: getSocialChannels
x-operation-id-source: derived
/social/validate:
post:
tags:
- Social API
summary: Check a (platform, handle) can post via the chosen path
security:
- AccountTokenAuth: []
- ApiKeyAuth: []
requestBody:
content:
application/json:
schema:
type: object
required:
- platform
- handle
properties:
platform:
type: string
handle:
type: string
method:
type: string
enum:
- session
- official
required: true
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
example: true
data:
type: object
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
operationId: postSocialValidate
x-operation-id-source: derived
components:
schemas:
ErrorResponse:
type: object
properties:
success:
type: boolean
example: false
error:
type: object
properties:
message:
type: string
code:
type: string
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: JWT access token from POST /auth/login
ApiKeyAuth:
type: http
scheme: bearer
description: Bot API key (nrn_xxx) from bot API keys management
AccountTokenAuth:
type: http
scheme: bearer
description: Account token (nrn_acc_xxx) from Dashboard > Settings > Account Tokens