Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.neuraldraft.io/llms.txt

Use this file to discover all available pages before exploring further.

The Social pillar is a standalone product: AI-generated posts in your brand voice, scheduled or published immediately to Facebook, Instagram, X, TikTok, LinkedIn or YouTube. You can use it without using the CMS or blog or commerce — many customers do.

​
What this gives you

  • Connected accounts for Facebook, Instagram, X, TikTok, LinkedIn, YouTube — OAuth handled by us.
  • AI generation per platform, with per-platform tone and length conventions baked in.
  • Per-platform content — write once, get six platform-tailored variants; override any of them by hand.
  • Scheduling — pick a date/time per post, or a tone calendar for a week of posts at once.
  • Publishing — fire-and-forget; we handle the platform APIs and surface per-platform success/failure on the resource.

​
Quick example

Generate and schedule a cross-platform post in one shot. 
# 1. Kick off generation
curl -X POST https://api.neuraldraft.io/v1/jobs \
  -H "Authorization: Bearer $NEURAL_DRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "social_post.generate",
    "custom_title": "Launching our v1 API",
    "platforms": ["facebook", "instagram", "twitter", "linkedin"],
    "tone": "warm",
    "media_type": "image",
    "visual_style": "minimal_brand"
  }'
# => { "job_id": "job_2Nh4PqRsTuVw", "status": "pending" }

# 2. After completion, schedule the resulting post
curl -X POST https://api.neuraldraft.io/v1/social-posts/882/schedule \
  -H "Authorization: Bearer $NEURAL_DRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scheduled_at":"2026-04-22T14:00:00Z"}'
Cost: 25 credits per platform for generation. Scheduling is free.

​
Common workflows

​
1. Connect a social account

curl -X POST https://api.neuraldraft.io/v1/social-accounts/connect/instagram \
  -H "Authorization: Bearer $NEURAL_DRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"redirect_uri":"https://example.com/oauth/callback"}'

{
  "oauth_url": "https://app.neuraldraft.io/oauth/instagram?state=...",
  "expires_in": 600
}
Surface the URL to the user. After they authorize, we redirect to your redirect_uri with ?status=connected&account_id=....

​
2. List connected accounts

curl https://api.neuraldraft.io/v1/social-accounts \
  -H "Authorization: Bearer $NEURAL_DRAFT_API_KEY"

{
  "data": [
    { "id": 12, "platform": "instagram", "username": "@acme", "is_active": true, "expires_at": "2026-09-01T00:00:00Z" }
  ]
}

​
3. Publish immediately, no scheduling

Skip schedule; call publish instead. 
curl -X POST https://api.neuraldraft.io/v1/social-posts/882/publish \
  -H "Authorization: Bearer $NEURAL_DRAFT_API_KEY"
The post enters published state on success per platform; check the publish_results field on the resource for per-platform outcomes: 
{
  "id": 882,
  "status": "published",
  "publish_results": [
    { "platform": "facebook", "status": "success", "external_id": "fb_post_..." },
    { "platform": "instagram", "status": "failed", "error": "media_too_large" }
  ]
}
Subscribe to social_post.failed to react to per-platform failures.

​
4. Override per-platform content

The AI generates platform-tailored variants; you can override any of them before publish: 
curl -X PUT https://api.neuraldraft.io/v1/social-posts/882 \
  -H "Authorization: Bearer $NEURAL_DRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "twitter_content": "Launching our v1 API today. ndsk_live_... in your hand in 60 seconds."
  }'

​
5. Generate from an existing blog post

Cross-promote a blog post to social with one call. The pipeline reads the post, summarises per platform, generates an image, and saves a draft. 
curl -X POST https://api.neuraldraft.io/v1/jobs \
  -H "Authorization: Bearer $NEURAL_DRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "social_post.generate",
    "post_id": 4711,
    "platforms": ["twitter", "linkedin"],
    "tone": "warm",
    "media_type": "image"
  }'

​
Reference

EndpointTag
GET /v1/social-postsSocial
POST /v1/social-postsSocial
GET /v1/social-posts/{id}Social
PUT /v1/social-posts/{id}Social
POST /v1/social-posts/{id}/publishSocial
POST /v1/social-posts/{id}/scheduleSocial
GET /v1/social-posts/{id}/statusSocial
GET /v1/social-accountsSocial
POST /v1/social-accounts/connect/{platform}Social
DELETE /v1/social-accounts/{id}Social
POST /v1/jobs (social_post.generate)Jobs