Social

Social media content generation and publishing

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

X-API-KEYstringRequired

Body

site_idstring · uuidRequired

platformstring · enumRequiredPossible values:

contentstring · max: 5000Required

hashtagsstring[]Optional

image_urlstring · uriOptional

video_urlstring · uriOptional

URL of a video to attach (preferred over image_url for video platforms like TikTok, YouTube)

Responses

200

Post published

application/json

successbooleanOptional

platformstringOptional

post_idstring · nullableOptional

late_post_idstring · nullableOptional

errorstring · nullableOptional

post

/v1/social/publish

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

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

200

Post published

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

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

X-API-KEYstringRequired

Body

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

video_urlstring · uriOptional

URL of a video to attach (preferred over image_url for video platforms like TikTok, YouTube)

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

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

{
  "site_id": "123e4567-e89b-12d3-a456-426614174000",
  "platform": "twitter",
  "content": "text",
  "scheduled_at": "2026-05-14T18:00:43.037Z",
  "hashtags": [
    "text"
  ],
  "image_url": "https://example.com",
  "video_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"
}

post

Generate a social media post from article content or a standalone topic. Provide article_title + article_summary, or just a topic. Requires Power plan or higher. Uses your OpenAI API key for text generation, and optionally Replicate API key for image generation.

Authorizations

X-API-KEYstringRequired

Body

Provide article_title + article_summary for article-derived posts, or provide topic for standalone posts.

site_idstring · uuidRequired

article_idstring · uuid · nullableOptional

topicstring · max: 500Optional

Standalone topic (alternative to article_title/article_summary)

article_titlestringOptional

Required if topic not provided

article_summarystringOptional

Required if topic not provided

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

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

{
  "site_id": "123e4567-e89b-12d3-a456-426614174000",
  "article_id": "123e4567-e89b-12d3-a456-426614174000",
  "topic": "text",
  "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-05-14T18:00:43.037Z",
    "brand_context_used": true
  }
}

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. Provide article_title + article_summary, or topic for standalone posts. Requires Power plan or higher.

Authorizations

X-API-KEYstringRequired

Body

site_idstring · uuidRequired

Site/brand ID

topicstring · max: 500Optional

Standalone topic (alternative to article fields)

article_titlestringOptional

Title of the article

article_summarystringOptional

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

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

{
  "site_id": "123e4567-e89b-12d3-a456-426614174000",
  "topic": "text",
  "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-05-14T18:00:43.037Z",
      "brand_context_used": true
    }
  }
}

get

Returns all supported platforms with character limits, format support, and content tips.

Authorizations

X-API-KEYstringRequired

Responses

200

List of platforms

application/json

get

/v1/social/platforms

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

200

List of platforms

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

get

List social media posts with optional filters.

Authorizations

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

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-05-14T18:00:43.037Z",
      "published_at": "2026-05-14T18:00:43.037Z",
      "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-05-14T18:00:43.037Z",
      "updated_at": "2026-05-14T18:00:43.037Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 1
}

get

Get a single social post by ID.

Authorizations

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}

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-05-14T18:00:43.037Z",
  "published_at": "2026-05-14T18:00:43.037Z",
  "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-05-14T18:00:43.037Z",
  "updated_at": "2026-05-14T18:00:43.037Z"
}

delete

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

Authorizations

X-API-KEYstringRequired

Path parameters

idstring · uuidRequired

Social post ID

Responses

200

Post deleted

application/json

deletedbooleanOptional

delete

/v1/social/posts/{id}

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

200

Post deleted

{
  "deleted": true
}

patch

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

Authorizations

X-API-KEYstringRequired

Path parameters

idstring · uuidRequired

Social post ID

Body

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}

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-05-14T18:00:43.037Z",
  "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-05-14T18:00:43.037Z",
  "published_at": "2026-05-14T18:00:43.037Z",
  "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-05-14T18:00:43.037Z",
  "updated_at": "2026-05-14T18:00:43.037Z"
}

post

Takes an existing draft social post and schedules it via Late.dev. Uses the post's scheduled_at timestamp, or defaults to tomorrow 9am UTC. The post must be in "draft" status and have a connected platform account.

Authorizations

X-API-KEYstringRequired

Path parameters

idstring · uuidRequired

Social post ID (must be in draft status)

Responses

200

Post scheduled

application/json

idstring · uuidOptional

statusstring · enumOptionalPossible values:

late_post_idstringOptional

scheduled_atstring · date-timeOptional

422

Post cannot be scheduled (not draft, no account connected, etc.)

post

/v1/social/posts/{id}/schedule

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

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "scheduled",
  "late_post_id": "text",
  "scheduled_at": "2026-05-14T18:00:43.037Z"
}

post

Takes an existing draft social post and publishes it immediately via Late.dev. The post must be in "draft" status and have a connected platform account.

Authorizations

X-API-KEYstringRequired

Path parameters

idstring · uuidRequired

Social post ID (must be in draft status)

Responses

200

Post published

application/json

idstring · uuidOptional

statusstring · enumOptionalPossible values:

late_post_idstringOptional

published_atstring · date-timeOptional

422

Post cannot be published (not draft, no account connected, etc.)

post

/v1/social/posts/{id}/publish

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

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "published",
  "late_post_id": "text",
  "published_at": "2026-05-14T18:00:43.037Z"
}

post

Schedule or publish multiple draft social posts at once. Processes posts sequentially to respect Late.dev rate limits. Returns partial success: individual post failures don't block others.

Authorizations

X-API-KEYstringRequired

Body

post_idsstring · uuid[] · min: 1 · max: 50Required

Array of draft social post IDs

actionstring · enumOptional

Action to perform on each post

Default: schedulePossible values:

Responses

200

Bulk operation results

application/json

post

/v1/social/posts/bulk-schedule

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

{
  "post_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "action": "schedule"
}

200

Bulk operation results

{
  "results": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "status": "scheduled",
      "late_post_id": "text",
      "scheduled_at": "2026-05-14T18:00:43.037Z",
      "published_at": "2026-05-14T18:00:43.037Z",
      "error": "text"
    }
  ]
}

get

Returns social media analytics for a site including impressions, engagements, clicks, shares, per-platform breakdowns, and top performing posts. Requires Solo plan or higher.

Authorizations

X-API-KEYstringRequired

Query parameters

site_idstring · uuidRequired

Site/brand ID

platformstringOptional

Filter by platform (e.g. twitter, linkedin)

from_datestring · date-timeOptional

Start date filter (ISO 8601)

to_datestring · date-timeOptional

End date filter (ISO 8601)

top_ninteger · max: 20Optional

Number of top posts to include

Default: 5

Responses

200

Social analytics summary

application/json

totalPostsintegerOptional

totalImpressionsintegerOptional

totalEngagementsintegerOptional

totalClicksintegerOptional

totalSharesintegerOptional

averageEngagementRatenumberOptional

get

/v1/social/analytics

GET /v1/social/analytics?site_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: api.cuppa.ai
X-API-KEY: YOUR_API_KEY
Accept: */*

200

Social analytics summary

{
  "totalPosts": 1,
  "totalImpressions": 1,
  "totalEngagements": 1,
  "totalClicks": 1,
  "totalShares": 1,
  "averageEngagementRate": 1,
  "byPlatform": {
    "ANY_ADDITIONAL_PROPERTY": {
      "posts": 1,
      "impressions": 1,
      "engagements": 1
    }
  },
  "topPosts": [
    {
      "id": "text",
      "platform": "text",
      "content": "text",
      "analytics": {
        "impressions": 1,
        "engagements": 1,
        "clicks": 1,
        "engagement_rate": 1
      }
    }
  ],
  "period": {
    "from": "text",
    "to": "text"
  }
}

post

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

Authorizations

X-API-KEYstringRequired

Body

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

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

{}

post

Publish a carousel to LinkedIn.

Authorizations

X-API-KEYstringRequired

Body

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

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-05-14T18:00:43.037Z"
}

201

Carousel published

{}

PreviousChat NextLinks

Last updated 6 days ago

Was this helpful?

hashtagPublish social post immediately

hashtagSchedule social post for future publishing

hashtagGenerate a social media post

hashtagGenerate social posts for multiple platforms

hashtagGet supported social platforms

hashtagList social posts

hashtagGet social post

hashtagDelete social post

hashtagUpdate social post

hashtagSchedule a draft social post

hashtagPublish a draft social post immediately

hashtagBulk schedule or publish draft social posts

hashtagGet social media analytics

hashtagGenerate carousel

hashtagPublish carousel

Publish social post immediately

Schedule social post for future publishing

Generate a social media post

Generate social posts for multiple platforms

Get supported social platforms

List social posts

Get social post

Delete social post

Update social post

Schedule a draft social post

Publish a draft social post immediately

Bulk schedule or publish draft social posts

Get social media analytics

Generate carousel

Publish carousel