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

successbooleanOptional

platformstringOptional

post_idstring · nullableOptional

late_post_idstring · nullableOptional

errorstring · nullableOptional

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

successbooleanOptional

platformstringOptional

post_idstring · nullableOptional

late_post_idstring · nullableOptional

scheduled_atstringOptional

statusstring · enumOptionalPossible values:

warningstring · nullableOptional

Warning message if post was saved as draft

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-03-22T03:34:21.871Z",
  "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-03-22T03:34:21.871Z",
    "brand_context_used": true
  }
}

Generate social posts for multiple platforms

post

Generate optimized social media posts for up to 5 platforms at once. Each platform gets tailored content based on its character limits and best practices. Requires Power plan or higher.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

site_idstring · uuidRequired

Site/brand ID

article_titlestringRequired

Title of the article

article_summarystringRequired

Brief summary of the article

article_urlstringOptional

Public URL of the article

tonestring · enumOptionalDefault: engagingPossible values:

include_hashtagsbooleanOptionalDefault: true

generate_imagesbooleanOptional

Generate images for each platform (requires Replicate API key)

Default: false

Responses

201

Posts generated for each platform

application/json

post

/v1/social/multi

HTTPcURLJavaScriptPython

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

{
  "site_id": "123e4567-e89b-12d3-a456-426614174000",
  "article_title": "text",
  "article_summary": "text",
  "article_url": "text",
  "platforms": [
    "twitter"
  ],
  "tone": "engaging",
  "include_hashtags": true,
  "generate_images": false
}

201

Posts generated for each platform

{
  "ANY_ADDITIONAL_PROPERTY": {
    "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-03-22T03:34:21.871Z",
      "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

idstringOptional

labelstringOptional

max_charactersintegerOptional

hashtags_supportedbooleanOptional

max_hashtagsintegerOptional

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
  }
]

List social posts

get

List social media posts with optional filters.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Query parameters

pageintegerOptional

Page number for pagination

limitinteger · max: 100Optional

Maximum number of posts to return

Default: 20

site_idstring · uuidOptional

Filter by site ID

platformstringOptional

Filter by platform

statusstring · enumOptional

Filter by status

Possible values:

Responses

200

A list of social posts

application/json

totalintegerOptional

pageintegerOptional

limitintegerOptional

get

/v1/social/posts

HTTPcURLJavaScriptPython

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

200

A list of social posts

{
  "posts": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "platform": "text",
      "content": "text",
      "hashtags": [
        "text"
      ],
      "image_url": "text",
      "status": "draft",
      "scheduled_at": "2026-03-22T03:34:21.871Z",
      "published_at": "2026-03-22T03:34:21.871Z",
      "article_id": "123e4567-e89b-12d3-a456-426614174000",
      "late_post_id": "text",
      "error_message": "text",
      "metadata": {},
      "post_type": "text",
      "voice_mode": "text",
      "site_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2026-03-22T03:34:21.871Z",
      "updated_at": "2026-03-22T03:34:21.871Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 1
}

Get social post

get

Get a single social post by ID.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Path parameters

idstring · uuidRequired

Social post ID

Responses

200

The social post

application/json

idstring · uuidOptional

platformstringOptional

contentstringOptional

hashtagsstring[]Optional

image_urlstring · nullableOptional

statusstring · enumOptionalPossible values:

scheduled_atstring · date-time · nullableOptional

published_atstring · date-time · nullableOptional

article_idstring · uuid · nullableOptional

late_post_idstring · nullableOptional

error_messagestring · nullableOptional

metadataobject · nullableOptional

post_typestring · nullableOptional

voice_modestring · nullableOptional

site_idstring · uuid · nullableOptional

created_atstring · date-timeOptional

updated_atstring · date-time · nullableOptional

get

/v1/social/posts/{id}

HTTPcURLJavaScriptPython

GET /v1/social/posts/{id} HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

The social post

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "platform": "text",
  "content": "text",
  "hashtags": [
    "text"
  ],
  "image_url": "text",
  "status": "draft",
  "scheduled_at": "2026-03-22T03:34:21.871Z",
  "published_at": "2026-03-22T03:34:21.871Z",
  "article_id": "123e4567-e89b-12d3-a456-426614174000",
  "late_post_id": "text",
  "error_message": "text",
  "metadata": {},
  "post_type": "text",
  "voice_mode": "text",
  "site_id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-03-22T03:34:21.871Z",
  "updated_at": "2026-03-22T03:34:21.871Z"
}

Delete social post

delete

Delete a draft or scheduled social post. Cannot delete published posts.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Path parameters

idstring · uuidRequired

Social post ID

Responses

200

Post deleted

application/json

deletedbooleanOptional

delete

/v1/social/posts/{id}

HTTPcURLJavaScriptPython

DELETE /v1/social/posts/{id} HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

Post deleted

{
  "deleted": true
}

Update social post

patch

Update a draft or scheduled social post. Cannot edit published posts.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Path parameters

idstring · uuidRequired

Social post ID

Body

application/json

contentstringOptional

hashtagsstring[]Optional

scheduled_atstring · date-timeOptional

image_urlstringOptional

Responses

200

Post updated

application/json

idstring · uuidOptional

platformstringOptional

contentstringOptional

hashtagsstring[]Optional

image_urlstring · nullableOptional

statusstring · enumOptionalPossible values:

scheduled_atstring · date-time · nullableOptional

published_atstring · date-time · nullableOptional

article_idstring · uuid · nullableOptional

late_post_idstring · nullableOptional

error_messagestring · nullableOptional

metadataobject · nullableOptional

post_typestring · nullableOptional

voice_modestring · nullableOptional

site_idstring · uuid · nullableOptional

created_atstring · date-timeOptional

updated_atstring · date-time · nullableOptional

patch

/v1/social/posts/{id}

HTTPcURLJavaScriptPython

PATCH /v1/social/posts/{id} HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "content": "text",
  "hashtags": [
    "text"
  ],
  "scheduled_at": "2026-03-22T03:34:21.871Z",
  "image_url": "text"
}

200

Post updated

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "platform": "text",
  "content": "text",
  "hashtags": [
    "text"
  ],
  "image_url": "text",
  "status": "draft",
  "scheduled_at": "2026-03-22T03:34:21.871Z",
  "published_at": "2026-03-22T03:34:21.871Z",
  "article_id": "123e4567-e89b-12d3-a456-426614174000",
  "late_post_id": "text",
  "error_message": "text",
  "metadata": {},
  "post_type": "text",
  "voice_mode": "text",
  "site_id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-03-22T03:34:21.871Z",
  "updated_at": "2026-03-22T03:34:21.871Z"
}

Generate carousel

post

Generate a LinkedIn carousel with AI-generated slides. Requires Business plan or higher.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

site_idstring · uuidRequired

topicstringRequired

Topic for the carousel

hookstringOptional

Opening hook text

target_audiencestringOptional

slide_countinteger · min: 3 · max: 15OptionalDefault: 6

tonestring · enumOptionalPossible values:

include_statsbooleanOptional

cta_textstringOptional

cta_urlstringOptional

generate_imagesbooleanOptionalDefault: true

Responses

201

Carousel generated

application/json

post

/v1/social/carousel

HTTPcURLJavaScriptPython

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

{
  "site_id": "123e4567-e89b-12d3-a456-426614174000",
  "topic": "text",
  "hook": "text",
  "target_audience": "text",
  "slide_count": 6,
  "tone": "casual",
  "include_stats": true,
  "cta_text": "text",
  "cta_url": "text",
  "generate_images": true
}

201

Carousel generated

{}

Publish carousel

post

Publish a carousel to LinkedIn.

Authorizations

ApiKeyAuth

X-API-KEYstringRequired

Body

application/json

site_idstring · uuidRequired

captionstringRequired

image_urlsstring[]Required

hashtagsstring[]Optional

scheduled_atstring · date-timeOptional

Omit for immediate publishing

Responses

201

Carousel published

application/json

post

/v1/social/carousel/publish

HTTPcURLJavaScriptPython

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

{
  "site_id": "123e4567-e89b-12d3-a456-426614174000",
  "caption": "text",
  "image_urls": [
    "text"
  ],
  "hashtags": [
    "text"
  ],
  "scheduled_at": "2026-03-22T03:34:21.871Z"
}

201

Carousel published

{}