Social

Social media content generation and publishing

Publish social post immediately

post

Publish a social media post immediately to a connected platform via Late.dev. The social account must be connected in Brand Settings first. Requires Power plan or higher.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

site_idstring · uuidRequired

platformstring · enumRequiredPossible values:

contentstring · max: 5000Required

hashtagsstring[]Optional

image_urlstring · uriOptional

Responses

200

Post published

application/json

post

/v1/social/publish

HTTPcURLJavaScriptPython

POST /v1/social/publish HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 142

{
  "site_id": "123e4567-e89b-12d3-a456-426614174000",
  "platform": "twitter",
  "content": "text",
  "hashtags": [
    "text"
  ],
  "image_url": "https://example.com"
}

200

Post published

{
  "success": true,
  "platform": "text",
  "post_id": "text",
  "late_post_id": "text",
  "error": "text"
}

Schedule social post for future publishing

post

Schedule a social media post for future publishing. The post is sent to Late.dev with the scheduled time. Requires Power plan or higher.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

site_idstring · uuidRequired

platformstring · enumRequiredPossible values:

contentstring · max: 5000Required

scheduled_atstring · date-timeRequired

ISO datetime when the post should be published

hashtagsstring[]Optional

image_urlstring · uriOptional

article_idstring · uuidOptional

Optional article ID to link this post to

Responses

200

Post scheduled

application/json

post

/v1/social/schedule

HTTPcURLJavaScriptPython

POST /v1/social/schedule HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 236

{
  "site_id": "123e4567-e89b-12d3-a456-426614174000",
  "platform": "twitter",
  "content": "text",
  "scheduled_at": "2026-02-04T17:21:46.957Z",
  "hashtags": [
    "text"
  ],
  "image_url": "https://example.com",
  "article_id": "123e4567-e89b-12d3-a456-426614174000"
}

200

Post scheduled

{
  "success": true,
  "platform": "text",
  "post_id": "text",
  "late_post_id": "text",
  "scheduled_at": "text",
  "status": "scheduled",
  "warning": "text"
}

Generate a social media post

post

Generate a social media post from article content. Requires Power plan or higher. Uses your OpenAI API key for text generation, and optionally Replicate API key for image generation.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

site_idstring · uuidRequired

article_idstring · uuid · nullableOptional

article_titlestringRequired

article_summarystringRequired

article_urlstring · uri · nullableOptional

platformstring · enumRequiredPossible values:

tonestring · enumOptionalDefault: engagingPossible values:

include_hashtagsbooleanOptionalDefault: true

max_hashtagsinteger · max: 30Optional

hook_typestring · enumOptionalPossible values:

generate_imagebooleanOptionalDefault: false

Responses

201

Social post generated

application/json

post

/v1/social

HTTPcURLJavaScriptPython

POST /v1/social HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 313

{
  "site_id": "123e4567-e89b-12d3-a456-426614174000",
  "article_id": "123e4567-e89b-12d3-a456-426614174000",
  "article_title": "text",
  "article_summary": "text",
  "article_url": "https://example.com",
  "platform": "twitter",
  "tone": "engaging",
  "include_hashtags": true,
  "max_hashtags": 1,
  "hook_type": "curiosity",
  "generate_image": false
}

201

Social post generated

{
  "content": "text",
  "hashtags": [
    "text"
  ],
  "image_prompt": "text",
  "image_url": "text",
  "platform": "text",
  "character_count": 1,
  "hook": "text",
  "metadata": {
    "tokens_used": 1,
    "model": "text",
    "generated_at": "2026-02-04T17:21:46.957Z",
    "brand_context_used": true
  }
}

Get supported social platforms

get

Returns all supported social platforms with their character limits and best practices.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Responses

200

List of platforms

application/json

get

/v1/social/platforms

HTTPcURLJavaScriptPython

GET /v1/social/platforms HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

List of platforms

[
  {
    "id": "text",
    "label": "text",
    "max_characters": 1,
    "hashtags_supported": true,
    "max_hashtags": 1
  }
]