Skip to main content
POST
/
social-posts
cURL (AI)
curl -X POST https://api.neuraldraft.io/v1/social-posts \
  -H "Authorization: Bearer ndsk_live_yourkey" \
  -H "Content-Type: application/json" \
  -d '{"ai":{"topic":"new Saturday class","platforms":["facebook","instagram"],"tone":"warm","media_type":"image"}}'
{
  "id": 88,
  "platforms": [
    "facebook",
    "instagram"
  ],
  "status": "scheduled",
  "title": "New Saturday morning class",
  "media": [
    "<string>"
  ],
  "content_per_platform": {
    "facebook": "New Saturday morning class — book now → lakesideyoga.uk",
    "instagram": "Slow down. Breathe. ✨ New Saturday morning class — link in bio."
  },
  "scheduled_at": "2023-11-07T05:31:56Z",
  "published_at": "2023-11-07T05:31:56Z",
  "publish_results": {
    "instagram": {
      "ok": true,
      "external_id": "ig_178214..."
    },
    "facebook": {
      "ok": false,
      "error": "Token expired"
    }
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Project API key. Pass as Authorization: Bearer ndsk_live_.... Manage keys via /projects/me/api-keys. Test-mode keys use the ndsk_test_ prefix.

Body

application/json
​
title
string
required
​
platforms
enum<string>[]
required
Minimum array length: 1
Available options:
facebook,
instagram,
twitter,
tiktok,
linkedin,
youtube
​
facebook_content
string
​
instagram_content
string
​
twitter_content
string
​
tiktok_content
string
​
linkedin_content
string
​
youtube_content
string
​
media_type
enum<string>
Available options:
image,
video,
carousel
​
media
string<uri>[]
​
scheduled_at
string<date-time>

Response

Manual post created.

​
id
integer
required
Example:

88

​
platforms
enum<string>[]
required
Available options:
facebook,
instagram,
twitter,
tiktok,
linkedin,
youtube
Example:
["facebook", "instagram"]
​
status
enum<string>
required
Available options:
draft,
scheduled,
published,
failed
Example:

"scheduled"

​
title
string
Example:

"New Saturday morning class"

​
media_type
enum<string> | null
Available options:
image,
video,
carousel
​
media
string<uri>[]
​
content_per_platform
object

Platform-specific copy.

Example:
{
  "facebook": "New Saturday morning class — book now → lakesideyoga.uk",
  "instagram": "Slow down. Breathe. ✨ New Saturday morning class — link in bio."
}
​
scheduled_at
string<date-time> | null
​
published_at
string<date-time> | null
​
publish_results
object

Per-platform publish outcomes.

Example:
{
  "instagram": { "ok": true, "external_id": "ig_178214..." },
  "facebook": { "ok": false, "error": "Token expired" }
}
​
created_at
string<date-time>
​
updated_at
string<date-time>