# Late API Documentation
This document contains the complete API documentation for the Late API.
---
# Authentication
How to get your API key and authenticate requests
All API requests require authentication using an API key. This page explains how to get your key and use it.
## Getting Your API Key
1. Log in to your Late account at [getlate.dev](https://getlate.dev)
2. Go to **Settings → API Keys**
3. Click **Create API Key**
4. Give it a name (e.g., "My App" or "CI/CD Pipeline")
5. Copy the key immediately — you won't be able to see it again
## API Key Format
| Component | Description |
|-----------|-------------|
| **Prefix** | `sk_` (3 characters) |
| **Body** | 32 random bytes as hex (64 characters) |
| **Total Length** | 67 characters |
**Example:**
```
sk_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v
```
**Key Preview (shown in dashboard):**
```
sk_a1b2c...d0e1f2
```
**Important:**
- Keys are only shown **once** at creation time
- Keys are stored as a **SHA-256 hash** for security (never stored in plain text)
- Limited to **10 active keys** per user
## Making Authenticated Requests
Include your API key in the `Authorization` header as a Bearer token:
```bash
curl https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY"
```
### Example: List Your Posts
```bash
curl https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer sk_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v"
```
### Example: Create a Post
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer sk_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v" \
-H "Content-Type: application/json" \
-d '{
"content": "Hello from the API!",
"platforms": [
{"platform": "twitter", "accountId": "acc_123"}
]
}'
```
## Using Environment Variables
Never hardcode your API key in your code. Use environment variables instead:
```bash
# Set the environment variable
export LATE_API_KEY="sk_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v"
# Use it in your requests
curl https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer $LATE_API_KEY"
```
### In Node.js
```javascript
const apiKey = process.env.LATE_API_KEY;
const response = await fetch('https://getlate.dev/api/v1/posts', {
headers: {
'Authorization': `Bearer ${apiKey}`,
'Content-Type': 'application/json'
}
});
```
### In Python
```python
import os
import requests
api_key = os.environ.get('LATE_API_KEY')
response = requests.get(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': f'Bearer {api_key}'}
)
```
## Error Responses
If authentication fails, you'll receive a `401 Unauthorized` response:
```json
{
"error": "Invalid or missing API key"
}
```
Common causes:
- Missing `Authorization` header
- Typo in the API key
- API key was deleted or expired
- Using `API_KEY` instead of `Bearer API_KEY`
## Security Best Practices
- **Never share your API key** publicly or commit it to git
- **Use environment variables** to store keys
- **Create separate keys** for different applications
- **Delete unused keys** from your dashboard
- **Rotate keys periodically** for enhanced security
## Managing API Keys Programmatically
You can also manage API keys via the API:
| Endpoint | Description |
|----------|-------------|
| `GET /v1/api-keys` | List your API keys |
| `POST /v1/api-keys` | Create a new API key |
| `DELETE /v1/api-keys/{keyId}` | Delete an API key |
See the [API Keys reference](/management/api-keys) for details.
## Next Step
Now that you can authenticate, let's [create your first post](/quickstart).
---
# Changelog
Stay up to date with the latest API changes and improvements
import { Changelog } from '@/components/changelog';
Track all updates to the Late API. We announce significant changes here and on our [Telegram channel](https://t.me/lateapi).
---
# Overview
Complete API docs for posting, scheduling, analytics, and inbox management across Twitter, Instagram, TikTok, LinkedIn, Facebook, YouTube, and more.
## What is Late?
Late is a social media scheduling platform that lets you manage and publish content across all major platforms from a single API. Whether you're building a social media tool, automating your content workflow, or managing multiple brands, Late's API gives you complete control.
## What can you do with the API?
- **Schedule posts** across Twitter, Instagram, Facebook, LinkedIn, TikTok, YouTube, Pinterest, Reddit, Bluesky, Threads, Google Business, Telegram, and Snapchat
- **Upload media** including images, videos, and documents
- **Manage multiple accounts** organized into profiles
- **Set up posting queues** with recurring time slots
- **Track analytics** across all your platforms
- **Manage your inbox** — respond to DMs, comments, and reviews from a unified API
- **Invite team members** to collaborate on content
## Base URL
All API requests use this base URL:
```
https://getlate.dev/api/v1
```
For example, to list your posts:
```
GET https://getlate.dev/api/v1/posts
```
## Key Concepts
Before you start, understand these core concepts:
### Profiles
Profiles are containers that group your social media accounts together. Think of them as "brands" or "projects". Each profile can have multiple connected social accounts.
### Accounts
These are your connected social media accounts (your Twitter account, Instagram page, etc.). Accounts belong to profiles.
### Posts
Content you want to publish. A single post can be scheduled to multiple accounts across different platforms simultaneously.
### Queue
An optional posting schedule. Set up recurring time slots (e.g., "Monday 9am, Wednesday 2pm") and Late will automatically schedule your posts to the next available slot.
## Platforms
Late supports 13 major social media platforms. Click on any platform to see its specific features and requirements:
| Platform | Supported Content | Guide |
|----------|-------------------|-------|
| Twitter/X | Text, images, videos, threads | [View Guide](/platforms/twitter) |
| Instagram | Feed, Stories, Reels, Carousels | [View Guide](/platforms/instagram) |
| Facebook | Pages, Stories, videos, multi-image | [View Guide](/platforms/facebook) |
| LinkedIn | Posts, images, videos, PDFs | [View Guide](/platforms/linkedin) |
| TikTok | Videos, photo carousels | [View Guide](/platforms/tiktok) |
| YouTube | Videos, Shorts | [View Guide](/platforms/youtube) |
| Pinterest | Pins with images or videos | [View Guide](/platforms/pinterest) |
| Reddit | Text posts, link posts | [View Guide](/platforms/reddit) |
| Bluesky | Text, images, videos | [View Guide](/platforms/bluesky) |
| Threads | Text, images, videos, sequences | [View Guide](/platforms/threads) |
| Google Business | Posts with CTAs | [View Guide](/platforms/google-business) |
| Telegram | Text, images, videos, albums | [View Guide](/platforms/telegram) |
| Snapchat | Stories, Saved Stories, Spotlight | [View Guide](/platforms/snapchat) |
For detailed media requirements and platform-specific features, visit the [Platforms Overview](/platforms).
## Rate Limits
API requests are rate limited based on your plan:
| Plan | Requests per Minute |
|------|---------------------|
| Free | 60 |
| Build | 120 |
| Accelerate | 600 |
| Unlimited | 1,200 |
Rate limit headers are included in every response so you can track your usage.
## Next Steps
Ready to get started?
1. **[Set up authentication](/auth)** — Get your API key and learn how to authenticate requests
2. **[Create your first post](/quickstart)** — Follow our step-by-step guide to schedule your first post
3. **[Explore platforms](/platforms)** — Learn platform-specific features and media requirements
---
# Pricing
Choose the plan that fits your needs - from free tier to unlimited enterprise
All plans include full API access, queue management, and support for all 13 platforms.
## Free
**$0/month**
Perfect for individuals and small brands.
---
## Build
**$19/month** or **$13/month** billed annually ($156/year)
For small teams and growing businesses.
---
## Accelerate
**$49/month** or **$33/month** billed annually ($396/year) — Most popular
For agencies and content creators.
Need more profiles? Add +50 profiles for **$49/month**.
---
## Unlimited
**$999/month** or **$667/month** billed annually ($8,004/year)
For large teams and enterprises.
---
## All Plans Include
| Feature | |
|---------|---|
| Full API access | ✓ |
| Queue management | ✓ |
| Calendar integration | ✓ |
| Post scheduling | ✓ |
| All 13 platforms | ✓ |
---
## Add-ons
### Analytics — $1/social set/month
Track post performance with detailed analytics across all platforms. View engagement metrics, reach, and insights. Available on any paid plan.
### Inbox — $1/social set/month
Unified inbox API for managing conversations, comments, and reviews across all connected accounts. Respond to DMs (Facebook, Instagram, Twitter/X, Bluesky, Reddit, Telegram), moderate comments (Facebook, Instagram, Twitter/X, Bluesky, Threads, YouTube, LinkedIn, Reddit, TikTok), and manage reviews (Facebook, Google Business). Available on any paid plan.
---
## Quick Comparison
| | Free | Build | Accelerate | Unlimited |
|---|:---:|:---:|:---:|:---:|
| **Monthly** | $0 | $19 | $49 | $999 |
| **Annual** | $0 | $13/mo | $33/mo | $667/mo |
| **Profiles** | 2 | 10 | 50 | ∞ |
| **Posts** | 20/mo | 120/mo | ∞ | ∞ |
| **Rate limit** | 60/min | 120/min | 600/min | 1,200/min |
---
## Get Started
For full pricing details and to sign up, visit [getlate.dev/pricing](https://getlate.dev/pricing).
---
# Quickstart
A complete walkthrough to schedule your first social media post with Late
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
This guide walks you through everything you need to schedule your first post. By the end, you'll have:
- Created a profile to organize your accounts
- Connected a social media account
- Scheduled a post to publish
**Prerequisites:** Make sure you have your [API key](/auth) ready.
## Step 1: Create a Profile
Profiles group your social accounts together. For example, you might have a "Personal Brand" profile with your Twitter and LinkedIn, and a "Company" profile with your business accounts.
```bash
curl -X POST https://getlate.dev/api/v1/profiles \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My First Profile",
"description": "Testing the Late API"
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/profiles', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'My First Profile',
description: 'Testing the Late API'
})
});
const { profile } = await response.json();
console.log('Profile created:', profile._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/profiles',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'name': 'My First Profile',
'description': 'Testing the Late API'
}
)
profile = response.json()['profile']
print(f"Profile created: {profile['_id']}")
```
**Response:**
```json
{
"message": "Profile created successfully",
"profile": {
"_id": "prof_abc123",
"name": "My First Profile",
"description": "Testing the Late API",
"createdAt": "2024-01-15T10:00:00.000Z"
}
}
```
Save the `_id` value — you'll need it for the next steps.
## Step 2: Connect a Social Account
Now connect a social media account to your profile. This uses OAuth, so it will redirect to the platform for authorization.
```bash
curl "https://getlate.dev/api/v1/connect/twitter?profileId=prof_abc123" \
-H "Authorization: Bearer YOUR_API_KEY"
```
```javascript
const response = await fetch(
'https://getlate.dev/api/v1/connect/twitter?profileId=prof_abc123',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const { authUrl } = await response.json();
// Redirect user to this URL to authorize
window.location.href = authUrl;
```
```python
import requests
response = requests.get(
'https://getlate.dev/api/v1/connect/twitter',
params={'profileId': 'prof_abc123'},
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
auth_url = response.json()['authUrl']
print(f"Open this URL to authorize: {auth_url}")
```
This returns a URL. Open it in a browser to authorize Late to access your Twitter account. After authorization, you'll be redirected back and the account will be connected.
### Available Platforms
Replace `twitter` with any of these:
| Platform | API Value | Guide |
|----------|-----------|-------|
| Twitter/X | `twitter` | [Twitter Guide](/platforms/twitter) |
| Instagram | `instagram` | [Instagram Guide](/platforms/instagram) |
| Facebook Pages | `facebook` | [Facebook Guide](/platforms/facebook) |
| LinkedIn | `linkedin` | [LinkedIn Guide](/platforms/linkedin) |
| TikTok | `tiktok` | [TikTok Guide](/platforms/tiktok) |
| YouTube | `youtube` | [YouTube Guide](/platforms/youtube) |
| Pinterest | `pinterest` | [Pinterest Guide](/platforms/pinterest) |
| Reddit | `reddit` | [Reddit Guide](/platforms/reddit) |
| Bluesky | `bluesky` | [Bluesky Guide](/platforms/bluesky) |
| Threads | `threads` | [Threads Guide](/platforms/threads) |
| Google Business | `googlebusiness` | [Google Business Guide](/platforms/google-business) |
| Telegram | `telegram` | [Telegram Guide](/platforms/telegram) |
| Snapchat | `snapchat` | [Snapchat Guide](/platforms/snapchat) |
## Step 3: Get Your Connected Accounts
After connecting, list your accounts to get the account ID:
```bash
curl "https://getlate.dev/api/v1/accounts" \
-H "Authorization: Bearer YOUR_API_KEY"
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/accounts', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});
const { accounts } = await response.json();
console.log('Connected accounts:', accounts);
```
```python
import requests
response = requests.get(
'https://getlate.dev/api/v1/accounts',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
accounts = response.json()['accounts']
for account in accounts:
print(f"{account['platform']}: {account['_id']}")
```
**Response:**
```json
{
"accounts": [
{
"_id": "acc_xyz789",
"platform": "twitter",
"username": "yourhandle",
"profileId": "prof_abc123"
}
]
}
```
Save the account `_id` — you need it to create posts.
## Step 4: Schedule Your First Post
Now you can schedule a post! Here's how to schedule a tweet for tomorrow at noon:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Hello world! This is my first post from the Late API 🚀",
"scheduledFor": "2024-01-16T12:00:00",
"timezone": "America/New_York",
"platforms": [
{
"platform": "twitter",
"accountId": "acc_xyz789"
}
]
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Hello world! This is my first post from the Late API 🚀',
scheduledFor: '2024-01-16T12:00:00',
timezone: 'America/New_York',
platforms: [
{
platform: 'twitter',
accountId: 'acc_xyz789'
}
]
})
});
const { post } = await response.json();
console.log('Post scheduled:', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Hello world! This is my first post from the Late API 🚀',
'scheduledFor': '2024-01-16T12:00:00',
'timezone': 'America/New_York',
'platforms': [
{
'platform': 'twitter',
'accountId': 'acc_xyz789'
}
]
}
)
post = response.json()['post']
print(f"Post scheduled: {post['_id']}")
```
**Response:**
```json
{
"message": "Post scheduled successfully",
"post": {
"_id": "post_123abc",
"content": "Hello world! This is my first post from the Late API 🚀",
"status": "scheduled",
"scheduledFor": "2024-01-16T17:00:00.000Z",
"platforms": [
{
"platform": "twitter",
"accountId": "acc_xyz789",
"status": "pending"
}
]
}
}
```
Your post is now scheduled and will publish automatically at the specified time.
## Posting to Multiple Platforms
You can post to multiple platforms at once. Just add more entries to the `platforms` array:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Cross-posting to all my accounts!",
"scheduledFor": "2024-01-16T12:00:00",
"timezone": "America/New_York",
"platforms": [
{"platform": "twitter", "accountId": "acc_twitter123"},
{"platform": "linkedin", "accountId": "acc_linkedin456"},
{"platform": "bluesky", "accountId": "acc_bluesky789"}
]
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Cross-posting to all my accounts!',
scheduledFor: '2024-01-16T12:00:00',
timezone: 'America/New_York',
platforms: [
{ platform: 'twitter', accountId: 'acc_twitter123' },
{ platform: 'linkedin', accountId: 'acc_linkedin456' },
{ platform: 'bluesky', accountId: 'acc_bluesky789' }
]
})
});
const { post } = await response.json();
console.log('Cross-posted:', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Cross-posting to all my accounts!',
'scheduledFor': '2024-01-16T12:00:00',
'timezone': 'America/New_York',
'platforms': [
{'platform': 'twitter', 'accountId': 'acc_twitter123'},
{'platform': 'linkedin', 'accountId': 'acc_linkedin456'},
{'platform': 'bluesky', 'accountId': 'acc_bluesky789'}
]
}
)
post = response.json()['post']
print(f"Cross-posted: {post['_id']}")
```
## Publishing Immediately
To publish right now instead of scheduling, use `publishNow: true`:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "This posts immediately!",
"publishNow": true,
"platforms": [
{"platform": "twitter", "accountId": "acc_xyz789"}
]
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'This posts immediately!',
publishNow: true,
platforms: [
{ platform: 'twitter', accountId: 'acc_xyz789' }
]
})
});
const { post } = await response.json();
console.log('Published:', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'This posts immediately!',
'publishNow': True,
'platforms': [
{'platform': 'twitter', 'accountId': 'acc_xyz789'}
]
}
)
post = response.json()['post']
print(f"Published: {post['_id']}")
```
## Creating a Draft
To save a post without publishing or scheduling:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "I will finish this later...",
"platforms": [
{"platform": "twitter", "accountId": "acc_xyz789"}
]
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'I will finish this later...',
platforms: [
{ platform: 'twitter', accountId: 'acc_xyz789' }
]
})
});
const { post } = await response.json();
console.log('Draft saved:', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'I will finish this later...',
'platforms': [
{'platform': 'twitter', 'accountId': 'acc_xyz789'}
]
}
)
post = response.json()['post']
print(f"Draft saved: {post['_id']}")
```
## What's Next?
Now that you've scheduled your first post, explore more features:
- **[Platform Guides](/platforms)** — Learn platform-specific features and requirements
- **[Upload media](/utilities/media)** — Add images and videos to your posts
- **[Set up a queue](/utilities/queue)** — Create recurring posting schedules
- **[View analytics](/core/analytics)** — Track how your posts perform
- **[Invite team members](/management/invites)** — Collaborate with your team
## Need Help?
Questions? Contact us at [miki@getlate.dev](mailto:miki@getlate.dev)
---
# Bluesky API
Post to Bluesky with Late API - text posts, images, and videos
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
## Quick Start
Post to Bluesky in under 60 seconds:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Hello from Late API! 🦋",
"platforms": [
{"platform": "bluesky", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Hello from Late API! 🦋',
platforms: [
{ platform: 'bluesky', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
const { post } = await response.json();
console.log('Posted to Bluesky!', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Hello from Late API! 🦋',
'platforms': [
{'platform': 'bluesky', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
post = response.json()['post']
print(f"Posted to Bluesky! {post['_id']}")
```
## Authentication
Bluesky uses **App Passwords** instead of OAuth. To connect a Bluesky account:
1. Go to your Bluesky Settings > App Passwords
2. Create a new App Password
3. Use the connect endpoint with your handle and app password
```bash
curl -X POST https://getlate.dev/api/v1/connect/bluesky \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"profileId": "YOUR_PROFILE_ID",
"handle": "yourhandle.bsky.social",
"appPassword": "xxxx-xxxx-xxxx-xxxx"
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/connect/bluesky', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
profileId: 'YOUR_PROFILE_ID',
handle: 'yourhandle.bsky.social',
appPassword: 'xxxx-xxxx-xxxx-xxxx'
})
});
const account = await response.json();
console.log('Connected:', account._id);
```
```python
response = requests.post(
'https://getlate.dev/api/v1/connect/bluesky',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'profileId': 'YOUR_PROFILE_ID',
'handle': 'yourhandle.bsky.social',
'appPassword': 'xxxx-xxxx-xxxx-xxxx'
}
)
account = response.json()
print(f"Connected: {account['_id']}")
```
## Image Requirements
| Property | Requirement |
|----------|-------------|
| **Max Images** | 4 per post |
| **Formats** | JPEG, PNG, WebP, GIF |
| **Max File Size** | 1 MB per image |
| **Max Dimensions** | 2000 × 2000 px |
| **Recommended** | 1200 × 675 px (16:9) |
### Aspect Ratios
| Type | Ratio | Dimensions |
|------|-------|------------|
| Landscape | 16:9 | 1200 × 675 px |
| Square | 1:1 | 1000 × 1000 px |
| Portrait | 4:5 | 800 × 1000 px |
## Post with Image
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Check out this photo! 📸",
"mediaItems": [
{"type": "image", "url": "https://example.com/photo.jpg"}
],
"platforms": [
{"platform": "bluesky", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Check out this photo! 📸',
mediaItems: [
{ type: 'image', url: 'https://example.com/photo.jpg' }
],
platforms: [
{ platform: 'bluesky', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Check out this photo! 📸',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/photo.jpg'}
],
'platforms': [
{'platform': 'bluesky', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
```
## Video Requirements
| Property | Requirement |
|----------|-------------|
| **Max Videos** | 1 per post |
| **Formats** | MP4 |
| **Max File Size** | 50 MB |
| **Max Duration** | 60 seconds |
| **Max Dimensions** | 1920 × 1080 px |
| **Frame Rate** | 30 fps recommended |
### Recommended Video Specs
| Property | Recommended |
|----------|-------------|
| Resolution | 1280 × 720 px (720p) |
| Aspect Ratio | 16:9 (landscape) or 1:1 (square) |
| Frame Rate | 30 fps |
| Codec | H.264 |
| Audio | AAC |
## Character Limits
- **Post text**: 300 characters
- **Alt text for images**: 1000 characters
Bluesky automatically detects and renders:
- URLs as link cards
- Mentions (@handle.bsky.social)
- Hashtags
## Link Cards
When your post contains a URL, Bluesky automatically generates a link card preview. For best results:
- Place the URL at the end of your post
- Ensure the target page has proper Open Graph meta tags
- The link card includes title, description, and thumbnail
## Common Issues
### Image Too Large
Bluesky has a strict 1 MB limit per image. Compress images before upload or Late will attempt automatic compression.
### App Password Invalid
- Ensure you're using an App Password, not your main account password
- App Passwords are formatted as `xxxx-xxxx-xxxx-xxxx`
- Create a new App Password if the current one isn't working
### Post Too Long
Bluesky has a 300 character limit. If your post exceeds this, consider:
- Shortening URLs (Bluesky shows link cards anyway)
- Splitting into multiple posts
- Moving detailed content to a linked page
## Inbox
> **Requires [Inbox add-on](/pricing)** — $1/social set/month
Bluesky supports DMs and comments.
### Direct Messages
| Feature | Supported |
|---------|-----------|
| List conversations | ✅ |
| Fetch messages | ✅ |
| Send text messages | ✅ |
| Send attachments | ❌ (API limitation) |
| Archive/unarchive | ✅ |
### Comments
| Feature | Supported |
|---------|-----------|
| List comments on posts | ✅ |
| Reply to comments | ✅ |
| Delete comments | ✅ |
| Like comments | ✅ (requires CID) |
| Unlike comments | ✅ (requires likeUri) |
### Limitations
- **No DM attachments** — Bluesky's Chat API does not support media
- **Like requires CID** — You must provide the content identifier (`cid`) when liking a comment
- **Unlike requires likeUri** — Store the `likeUri` returned when liking to unlike later
See [Messages](/core/messages) and [Comments](/core/comments) API Reference for endpoint details.
## Related API Endpoints
- [Connect Bluesky Account](/core/connect) — App Password authentication
- [Create Post](/core/posts) — Post creation and scheduling
- [Upload Media](/utilities/media) — Image and video uploads
- [Messages](/core/messages) and [Comments](/core/comments)
---
# Facebook API
Post to Facebook with Late API - Pages, Stories, Reels, and multi-image posts
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
## Quick Start
Post to Facebook in under 60 seconds:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Hello from Late API! 🚀",
"platforms": [
{"platform": "facebook", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Hello from Late API! 🚀',
platforms: [
{ platform: 'facebook', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
const { post } = await response.json();
console.log('Posted to Facebook!', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Hello from Late API! 🚀',
'platforms': [
{'platform': 'facebook', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
post = response.json()['post']
print(f"Posted to Facebook! {post['_id']}")
```
## Image Requirements
| Property | Feed Post | Story |
|----------|-----------|-------|
| **Max Images** | 10 | 1 |
| **Formats** | JPEG, PNG, GIF, WebP | JPEG, PNG |
| **Max File Size** | 10 MB | 10 MB |
| **Recommended** | 1200 × 630 px | 1080 × 1920 px |
| **Min Dimensions** | 200 × 200 px | 500 × 500 px |
### Aspect Ratios
| Type | Ratio | Dimensions | Use Case |
|------|-------|------------|----------|
| Landscape | 1.91:1 | 1200 × 630 px | Link previews, standard |
| Square | 1:1 | 1080 × 1080 px | Engagement posts |
| Portrait | 4:5 | 1080 × 1350 px | Mobile-optimized |
| Story | 9:16 | 1080 × 1920 px | Stories only |
## Video Requirements
| Property | Feed Video | Story |
|----------|------------|-------|
| **Max Videos** | 1 | 1 |
| **Formats** | MP4, MOV | MP4, MOV |
| **Max File Size** | 4 GB | 4 GB |
| **Max Duration** | 240 minutes | 120 seconds |
| **Min Duration** | 1 second | 1 second |
| **Resolution** | Up to 4K | 1080 × 1920 px |
| **Frame Rate** | 30 fps recommended | 30 fps |
### Recommended Video Specs
| Property | Recommended |
|----------|-------------|
| Resolution | 1280 × 720 px (720p) min |
| Aspect Ratio | 16:9 (landscape), 9:16 (Stories) |
| Codec | H.264 |
| Audio | AAC, 128 kbps stereo |
| Bitrate | 8 Mbps for 1080p |
## Multi-Image Posts
Facebook supports up to **10 images** in a single post:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Photo dump from the weekend! 📸",
"mediaItems": [
{"type": "image", "url": "https://example.com/photo1.jpg"},
{"type": "image", "url": "https://example.com/photo2.jpg"},
{"type": "image", "url": "https://example.com/photo3.jpg"}
],
"platforms": [
{"platform": "facebook", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Photo dump from the weekend! 📸',
mediaItems: [
{ type: 'image', url: 'https://example.com/photo1.jpg' },
{ type: 'image', url: 'https://example.com/photo2.jpg' },
{ type: 'image', url: 'https://example.com/photo3.jpg' }
],
platforms: [
{ platform: 'facebook', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Photo dump from the weekend! 📸',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/photo1.jpg'},
{'type': 'image', 'url': 'https://example.com/photo2.jpg'},
{'type': 'image', 'url': 'https://example.com/photo3.jpg'}
],
'platforms': [
{'platform': 'facebook', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
```
**Note:** You cannot mix images and videos in the same post.
## Facebook Stories
Stories are 24-hour ephemeral content. To post as a Story:
```json
{
"mediaItems": [
{ "type": "image", "url": "https://example.com/story.jpg" }
],
"platforms": [
{
"platform": "facebook",
"accountId": "acc_123",
"platformSpecificData": {
"contentType": "story"
}
}
]
}
```
### Story Requirements
- **Media required** - Stories must have an image or video
- **No text captions** - Text won't display on Stories
- **Disappear after 24 hours**
- Recommended: 1080 × 1920 px (9:16)
## First Comment
Add an automatic first comment to your post:
```json
{
"content": "New product launch! 🚀",
"mediaItems": [
{ "type": "image", "url": "https://example.com/product.jpg" }
],
"platforms": [
{
"platform": "facebook",
"accountId": "acc_123",
"platformSpecificData": {
"firstComment": "Link to purchase: https://shop.example.com"
}
}
]
}
```
**Note:** First comments don't work with Stories.
## Multi-Page Posting
If your connected Facebook account manages multiple Pages, you can post to different Pages from the same account connection.
### List Available Pages
First, retrieve the list of Pages you can post to:
```bash
curl -X GET https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/facebook-page \
-H "Authorization: Bearer YOUR_API_KEY"
```
```javascript
const response = await fetch(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/facebook-page',
{
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
}
);
const pages = await response.json();
console.log('Available pages:', pages);
```
```python
response = requests.get(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/facebook-page',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
pages = response.json()
print('Available pages:', pages)
```
### Post to Multiple Pages
Use the same `accountId` multiple times with different `pageId` values:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Exciting news from all our brands! 🎉",
"platforms": [
{
"platform": "facebook",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"pageId": "111111111"
}
},
{
"platform": "facebook",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"pageId": "222222222"
}
}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Exciting news from all our brands! 🎉',
platforms: [
{
platform: 'facebook',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: { pageId: '111111111' }
},
{
platform: 'facebook',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: { pageId: '222222222' }
}
],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Exciting news from all our brands! 🎉',
'platforms': [
{
'platform': 'facebook',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {'pageId': '111111111'}
},
{
'platform': 'facebook',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {'pageId': '222222222'}
}
],
'publishNow': True
}
)
```
## Page Targeting
If you manage multiple Pages, specify which one:
```json
{
"platforms": [
{
"platform": "facebook",
"accountId": "acc_123",
"platformSpecificData": {
"pageId": "123456789"
}
}
]
}
```
## GIF Support
Facebook supports animated GIFs:
- Treated as videos internally
- Auto-play in feed
- Max file size: 25 MB recommended
- Loop automatically
## Common Issues
### "Cannot mix media types"
Facebook doesn't allow images and videos in the same post. Create separate posts for each.
### Story has no caption
This is expected behavior. Facebook Stories don't display text captions. Add text as an image overlay instead.
### Video processing taking long
Large videos (>100 MB) may take several minutes to process. Use scheduled posts for async processing.
### Image looks cropped
Facebook auto-crops to fit feed. Use recommended aspect ratios (1.91:1, 1:1, or 4:5) for best results.
## Inbox
> **Requires [Inbox add-on](/pricing)** — $1/social set/month
Facebook has the most complete inbox support across DMs, comments, and reviews.
### Direct Messages
| Feature | Supported |
|---------|-----------|
| List conversations | ✅ |
| Fetch messages | ✅ |
| Send text messages | ✅ |
| Send attachments | ✅ (images, videos, audio, files) |
| Quick replies | ✅ (up to 13, Meta quick_replies) |
| Buttons | ✅ (up to 3, generic template) |
| Carousels | ✅ (generic template, up to 10 elements) |
| Message tags | ✅ (4 types) |
| Archive/unarchive | ✅ |
**Message tags:** Use `messagingType: "MESSAGE_TAG"` with one of: `CONFIRMED_EVENT_UPDATE`, `POST_PURCHASE_UPDATE`, `ACCOUNT_UPDATE`, or `HUMAN_AGENT` to send messages outside the 24-hour messaging window.
### Persistent Menu
Manage the persistent menu shown in Facebook Messenger conversations. Max 3 top-level items, max 5 nested items.
See [Account Settings](/core/account-settings) for the `GET/PUT/DELETE /v1/accounts/{accountId}/messenger-menu` endpoints.
### Comments
| Feature | Supported |
|---------|-----------|
| List comments on posts | ✅ |
| Reply to comments | ✅ |
| Delete comments | ✅ |
| Like comments | ✅ |
| Hide/unhide comments | ✅ |
### Reviews (Pages)
| Feature | Supported |
|---------|-----------|
| List reviews | ✅ |
| Reply to reviews | ✅ |
## Related API Endpoints
- [Connect Facebook Account](/core/connect) — OAuth flow
- [Create Post](/core/posts) — Post creation and scheduling
- [Upload Media](/utilities/media) — Image and video uploads
- [Analytics](/core/analytics) — Post performance metrics
- [Messages](/core/messages), [Comments](/core/comments), and [Reviews](/core/reviews)
- [Account Settings](/core/account-settings) — Persistent menu configuration
---
# Google Business API
Post to Google Business Profile with Late API - Updates, CTAs, and location posts
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
## Quick Start
Create a Google Business Profile post:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "🎉 We are open this holiday weekend! Stop by for our special seasonal menu.",
"mediaItems": [
{"type": "image", "url": "https://example.com/holiday-special.jpg"}
],
"platforms": [
{"platform": "googlebusiness", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: '🎉 We are open this holiday weekend! Stop by for our special seasonal menu.',
mediaItems: [
{ type: 'image', url: 'https://example.com/holiday-special.jpg' }
],
platforms: [
{ platform: 'googlebusiness', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
const { post } = await response.json();
console.log('Posted to Google Business!', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': '🎉 We are open this holiday weekend! Stop by for our special seasonal menu.',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/holiday-special.jpg'}
],
'platforms': [
{'platform': 'googlebusiness', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
post = response.json()['post']
print(f"Posted to Google Business! {post['_id']}")
```
## Overview
Google Business Profile posts support **text and a single image**. Videos are not supported.
## Image Requirements
| Property | Requirement |
|----------|-------------|
| **Max Images** | 1 per post |
| **Formats** | JPEG, PNG |
| **Max File Size** | 5 MB |
| **Min Dimensions** | 250 × 250 px |
| **Recommended** | 1200 × 900 px (4:3) |
### Aspect Ratios
| Ratio | Dimensions | Notes |
|-------|------------|-------|
| 4:3 | 1200 × 900 px | **Recommended** |
| 1:1 | 1080 × 1080 px | Square, good for profile |
| 16:9 | 1200 × 675 px | Landscape |
> **Note:** Google may crop images. Use 4:3 for best results.
## Call-to-Action Buttons
Google Business posts can include CTA buttons:
## Post Language (languageCode)
By default, Google Business Profile post language is auto-detected from your post text. If auto-detection may be inaccurate (very short posts, mixed-language content, transliterated text), set `platformSpecificData.languageCode` using a BCP 47 language code (for example: `en`, `de`, `es`, `fr`).
> **Note:** `languageCode` only affects language metadata for the post content; it does not translate your text.
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Diese Woche: 20% Rabatt auf alle Services.",
"mediaItems": [
{"type": "image", "url": "https://example.com/promo.jpg"}
],
"platforms": [{
"platform": "googlebusiness",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"languageCode": "de"
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Diese Woche: 20% Rabatt auf alle Services.',
mediaItems: [
{ type: 'image', url: 'https://example.com/promo.jpg' }
],
platforms: [{
platform: 'googlebusiness',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
languageCode: 'de'
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Diese Woche: 20% Rabatt auf alle Services.',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/promo.jpg'}
],
'platforms': [{
'platform': 'googlebusiness',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'languageCode': 'de'
}
}],
'publishNow': True
}
)
```
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Book your appointment today! Limited spots available this week.",
"mediaItems": [
{"type": "image", "url": "https://example.com/booking.jpg"}
],
"platforms": [{
"platform": "googlebusiness",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"callToAction": {
"type": "BOOK",
"url": "https://mybusiness.com/book"
}
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Book your appointment today! Limited spots available this week.',
mediaItems: [
{ type: 'image', url: 'https://example.com/booking.jpg' }
],
platforms: [{
platform: 'googlebusiness',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
callToAction: {
type: 'BOOK',
url: 'https://mybusiness.com/book'
}
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Book your appointment today! Limited spots available this week.',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/booking.jpg'}
],
'platforms': [{
'platform': 'googlebusiness',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'callToAction': {
'type': 'BOOK',
'url': 'https://mybusiness.com/book'
}
}
}],
'publishNow': True
}
)
```
### Available CTA Types
| Type | Description | Best For |
|------|-------------|----------|
| `LEARN_MORE` | Link to more information | Articles, about pages |
| `BOOK` | Booking/reservation link | Services, appointments |
| `ORDER` | Online ordering link | Restaurants, food |
| `SHOP` | E-commerce link | Retail, products |
| `SIGN_UP` | Registration link | Events, newsletters |
| `CALL` | Phone call action | Contact, inquiries |
## Post Without Image
Text-only posts are supported:
```json
{
"content": "Happy Friday! 🎉 We're offering 20% off all services this weekend. Mention this post when you visit!",
"platforms": [
{ "platform": "googlebusiness", "accountId": "acc_123" }
]
}
```
## Image URL Requirements
Google Business has strict image requirements:
| Requirement | Details |
|-------------|---------|
| **Public URL** | Must be publicly accessible |
| **HTTPS** | Secure URLs only |
| **No redirects** | Direct link to image |
| **No auth required** | Can't require login |
```
✅ https://mybucket.s3.amazonaws.com/image.jpg
✅ https://example.com/images/post.png
❌ https://example.com/image?token=abc (auth required)
❌ http://example.com/image.jpg (not HTTPS)
```
## Video Limitations
**Google Business Profile does not support video posts.** This is a platform limitation.
For video content:
- Post to other platforms (YouTube, Instagram)
- Include a link to the video in your text
- Use a video thumbnail as your image with a "Watch" CTA
## Location Selection
If you have multiple locations, you must have a connected account for each location. The account ID determines which location receives the post.
## Multi-Location Posting
If your connected Google Business account manages multiple locations, you can post to different locations from the same account connection.
### List Available Locations
First, retrieve the list of locations you can post to:
```bash
curl -X GET https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-locations \
-H "Authorization: Bearer YOUR_API_KEY"
```
```javascript
const response = await fetch(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-locations',
{
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
}
);
const locations = await response.json();
console.log('Available locations:', locations);
```
```python
response = requests.get(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-locations',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
locations = response.json()
print('Available locations:', locations)
```
### Post to Multiple Locations
Use the same `accountId` multiple times with different `locationId` values:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Now open at all locations! Visit us today 🎉",
"mediaItems": [
{"type": "image", "url": "https://example.com/store.jpg"}
],
"platforms": [
{
"platform": "googlebusiness",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"locationId": "locations/111111111"
}
},
{
"platform": "googlebusiness",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"locationId": "locations/222222222"
}
}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Now open at all locations! Visit us today 🎉',
mediaItems: [
{ type: 'image', url: 'https://example.com/store.jpg' }
],
platforms: [
{
platform: 'googlebusiness',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: { locationId: 'locations/111111111' }
},
{
platform: 'googlebusiness',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: { locationId: 'locations/222222222' }
}
],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Now open at all locations! Visit us today 🎉',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/store.jpg'}
],
'platforms': [
{
'platform': 'googlebusiness',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {'locationId': 'locations/111111111'}
},
{
'platform': 'googlebusiness',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {'locationId': 'locations/222222222'}
}
],
'publishNow': True
}
)
```
> **Note:** The `locationId` format is `locations/` followed by the location ID number.
## Post Visibility
Posts appear on:
- Your Google Business Profile
- Google Search (when searching your business)
- Google Maps
- Google Knowledge Panel
## Character Limits
| Property | Limit |
|----------|-------|
| Post text | 1500 characters |
| CTA URL | Standard URL length |
## Best Practices
### Image Tips
- Use high-quality, relevant images
- Show your products/services
- Include your branding subtly
- Avoid excessive text overlay
- Keep important content in center (cropping)
### Content Tips
- Include a clear call-to-action
- Mention offers or specials
- Keep it relevant and timely
- Update regularly (weekly posts)
## Common Issues
### "Image not found"
- Verify URL is publicly accessible
- Check for authentication requirements
- Ensure HTTPS
- Test URL in incognito browser
### "Invalid image format"
- Use JPEG or PNG only
- WebP and GIF not supported
- Check file isn't corrupted
### "Image too small"
Minimum 250 × 250 px. Recommended: 1200 × 900 px.
### Post not appearing
- Posts may take 24-48 hours to appear
- Check Google Business Console for approval status
- Ensure account is verified
### CTA not working
- Verify URL is valid and accessible
- Use HTTPS
- Avoid shortened URLs
## Inbox
> **Requires [Inbox add-on](/pricing)** — $1/social set/month
Google Business supports reviews management only.
### Reviews
| Feature | Supported |
|---------|-----------|
| List reviews | ✅ |
| Reply to reviews | ✅ |
| Delete reply | ✅ |
### Limitations
- **No DMs** — Google Business does not have a messaging system accessible via API
- **No comments** — Posts on Google Business do not support comments
See [Reviews API Reference](/core/reviews) for endpoint details.
## Food Menus
Manage food menus for Google Business Profile locations that support them (restaurants, cafes, etc.).
### Get Menus
```bash
curl -X GET https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-food-menus \
-H "Authorization: Bearer YOUR_API_KEY"
```
```javascript
const response = await fetch(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-food-menus',
{
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
}
);
const { menus } = await response.json();
console.log('Food menus:', menus);
```
```python
response = requests.get(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-food-menus',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
menus = response.json()
print('Food menus:', menus)
```
### Update Menus
```bash
curl -X PUT https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-food-menus \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"menus": [{
"labels": [{"displayName": "Lunch Menu", "languageCode": "en"}],
"sections": [{
"labels": [{"displayName": "Appetizers"}],
"items": [{
"labels": [{"displayName": "Caesar Salad", "description": "Romaine, parmesan, croutons"}],
"attributes": {
"price": {"currencyCode": "USD", "units": "12"},
"dietaryRestriction": ["VEGETARIAN"]
}
}]
}]
}],
"updateMask": "menus"
}'
```
```javascript
const response = await fetch(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-food-menus',
{
method: 'PUT',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
menus: [{
labels: [{ displayName: 'Lunch Menu', languageCode: 'en' }],
sections: [{
labels: [{ displayName: 'Appetizers' }],
items: [{
labels: [{ displayName: 'Caesar Salad', description: 'Romaine, parmesan, croutons' }],
attributes: {
price: { currencyCode: 'USD', units: '12' },
dietaryRestriction: ['VEGETARIAN']
}
}]
}]
}],
updateMask: 'menus'
})
}
);
```
```python
response = requests.put(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-food-menus',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'menus': [{
'labels': [{'displayName': 'Lunch Menu', 'languageCode': 'en'}],
'sections': [{
'labels': [{'displayName': 'Appetizers'}],
'items': [{
'labels': [{'displayName': 'Caesar Salad', 'description': 'Romaine, parmesan, croutons'}],
'attributes': {
'price': {'currencyCode': 'USD', 'units': '12'},
'dietaryRestriction': ['VEGETARIAN']
}
}]
}]
}],
'updateMask': 'menus'
}
)
```
Menu items support `price` (with currency code), `dietaryRestriction` (VEGETARIAN, VEGAN, GLUTEN_FREE), `allergen` (DAIRY, GLUTEN, SHELLFISH), `spiciness`, `servesNumPeople`, and `preparationMethods`.
See the [GMB Food Menus API Reference](/utilities/gmb-food-menus) for full schema details.
## Location Details
Read and update your business information including hours, special hours, description, phone numbers, and website.
```bash
# Get location details
curl -X GET "https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-location-details?readMask=regularHours,specialHours,profile,websiteUri" \
-H "Authorization: Bearer YOUR_API_KEY"
# Update business hours
curl -X PUT https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-location-details \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"updateMask": "regularHours",
"regularHours": {
"periods": [
{"openDay": "MONDAY", "openTime": "09:00", "closeDay": "MONDAY", "closeTime": "17:00"},
{"openDay": "TUESDAY", "openTime": "09:00", "closeDay": "TUESDAY", "closeTime": "17:00"}
]
}
}'
```
```javascript
// Get location details
const details = await fetch(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-location-details?readMask=regularHours,specialHours,profile,websiteUri',
{ headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
).then(r => r.json());
// Update business hours
await fetch('https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-location-details', {
method: 'PUT',
headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
body: JSON.stringify({
updateMask: 'regularHours',
regularHours: {
periods: [
{ openDay: 'MONDAY', openTime: '09:00', closeDay: 'MONDAY', closeTime: '17:00' },
{ openDay: 'TUESDAY', openTime: '09:00', closeDay: 'TUESDAY', closeTime: '17:00' }
]
}
})
});
```
```python
# Get location details
details = requests.get(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-location-details',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'readMask': 'regularHours,specialHours,profile,websiteUri'}
).json()
# Update business hours
requests.put(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-location-details',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'updateMask': 'regularHours',
'regularHours': {
'periods': [
{'openDay': 'MONDAY', 'openTime': '09:00', 'closeDay': 'MONDAY', 'closeTime': '17:00'},
{'openDay': 'TUESDAY', 'openTime': '09:00', 'closeDay': 'TUESDAY', 'closeTime': '17:00'}
]
}
}
)
```
Use `readMask` to request specific fields and `updateMask` to update them. Available fields include `regularHours`, `specialHours`, `profile.description`, `websiteUri`, and `phoneNumbers`.
See the [GMB Location Details API Reference](/utilities/gmb-location-details) for the full schema.
## Media (Photos)
Upload, list, and delete photos for your Google Business Profile listing.
```bash
# List photos
curl -X GET https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-media \
-H "Authorization: Bearer YOUR_API_KEY"
# Upload a photo
curl -X POST https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-media \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sourceUrl": "https://example.com/photos/interior.jpg",
"description": "Dining area with outdoor seating",
"category": "INTERIOR"
}'
```
```javascript
// List photos
const media = await fetch(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-media',
{ headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
).then(r => r.json());
// Upload a photo
await fetch('https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-media', {
method: 'POST',
headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
body: JSON.stringify({
sourceUrl: 'https://example.com/photos/interior.jpg',
description: 'Dining area with outdoor seating',
category: 'INTERIOR'
})
});
```
```python
# List photos
media = requests.get(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-media',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
).json()
# Upload a photo
requests.post(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-media',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'sourceUrl': 'https://example.com/photos/interior.jpg',
'description': 'Dining area with outdoor seating',
'category': 'INTERIOR'
}
)
```
Photo categories: `COVER`, `PROFILE`, `LOGO`, `EXTERIOR`, `INTERIOR`, `FOOD_AND_DRINK`, `MENU`, `PRODUCT`, `TEAMS`, `ADDITIONAL`.
See the [GMB Media API Reference](/utilities/gmb-media) for full details.
## Attributes
Manage amenities and services like delivery, Wi-Fi, outdoor seating, and payment types.
```bash
# Get attributes
curl -X GET https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-attributes \
-H "Authorization: Bearer YOUR_API_KEY"
# Update attributes
curl -X PUT https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-attributes \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"attributes": [
{"name": "has_delivery", "values": [true]},
{"name": "has_outdoor_seating", "values": [true]}
],
"attributeMask": "has_delivery,has_outdoor_seating"
}'
```
```javascript
// Get attributes
const attrs = await fetch(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-attributes',
{ headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
).then(r => r.json());
// Update attributes
await fetch('https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-attributes', {
method: 'PUT',
headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
body: JSON.stringify({
attributes: [
{ name: 'has_delivery', values: [true] },
{ name: 'has_outdoor_seating', values: [true] }
],
attributeMask: 'has_delivery,has_outdoor_seating'
})
});
```
```python
# Get attributes
attrs = requests.get(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-attributes',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
).json()
# Update attributes
requests.put(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-attributes',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'attributes': [
{'name': 'has_delivery', 'values': [True]},
{'name': 'has_outdoor_seating', 'values': [True]}
],
'attributeMask': 'has_delivery,has_outdoor_seating'
}
)
```
Available attributes vary by business category. Common ones include `has_dine_in`, `has_takeout`, `has_delivery`, `has_wifi`, `has_outdoor_seating`, and `pay_credit_card_types_accepted`.
See the [GMB Attributes API Reference](/utilities/gmb-attributes) for full details.
## Place Actions
Manage booking, ordering, and reservation buttons that appear on your listing.
```bash
# List place actions
curl -X GET https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-place-actions \
-H "Authorization: Bearer YOUR_API_KEY"
# Create a place action
curl -X POST https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-place-actions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"uri": "https://order.ubereats.com/mybusiness",
"placeActionType": "FOOD_ORDERING"
}'
```
```javascript
// List place actions
const actions = await fetch(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-place-actions',
{ headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
).then(r => r.json());
// Create a place action
await fetch('https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-place-actions', {
method: 'POST',
headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
body: JSON.stringify({
uri: 'https://order.ubereats.com/mybusiness',
placeActionType: 'FOOD_ORDERING'
})
});
```
```python
# List place actions
actions = requests.get(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-place-actions',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
).json()
# Create a place action
requests.post(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/gmb-place-actions',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'uri': 'https://order.ubereats.com/mybusiness',
'placeActionType': 'FOOD_ORDERING'
}
)
```
Action types: `APPOINTMENT`, `ONLINE_APPOINTMENT`, `DINING_RESERVATION`, `FOOD_ORDERING`, `FOOD_DELIVERY`, `FOOD_TAKEOUT`, `SHOP_ONLINE`.
See the [GMB Place Actions API Reference](/utilities/gmb-place-actions) for full details.
## Related API Endpoints
- [Connect Google Business Account](/core/connect) — OAuth flow
- [Create Post](/core/posts) — Post creation and scheduling
- [Upload Media](/utilities/media) — Image uploads
- [GMB Reviews](/utilities/gmb-reviews) — Manage reviews
- [GMB Food Menus](/utilities/gmb-food-menus) — Manage food menus
- [GMB Location Details](/utilities/gmb-location-details) — Hours, description, contact info
- [GMB Media](/utilities/gmb-media) — Photos management
- [GMB Attributes](/utilities/gmb-attributes) — Amenities and services
- [GMB Place Actions](/utilities/gmb-place-actions) — Booking and ordering links
- [Reviews](/core/reviews)
---
# Overview
Complete guide to all social media platforms supported by Late API
Late supports 13 major social media platforms. Each platform page includes quick start examples, media requirements, and platform-specific features.
## Platform Quick Reference
| Platform | Connect | Post | Analytics | Media Requirements |
|----------|---------|------|-----------|-------------------|
| [Twitter/X](/platforms/twitter) | OAuth 2.0 | Text, Images, Videos, Threads | Yes | [View](/platforms/twitter#image-requirements) |
| [Instagram](/platforms/instagram) | OAuth 2.0 | Feed, Stories, Reels, Carousels | Yes | [View](/platforms/instagram#image-requirements) |
| [Facebook](/platforms/facebook) | OAuth 2.0 | Text, Images, Videos, Reels | Yes | [View](/platforms/facebook#image-requirements) |
| [LinkedIn](/platforms/linkedin) | OAuth 2.0 | Text, Images, Videos, Documents | Yes | [View](/platforms/linkedin#image-requirements) |
| [TikTok](/platforms/tiktok) | OAuth 2.0 | Videos | Yes | [View](/platforms/tiktok#video-requirements) |
| [YouTube](/platforms/youtube) | OAuth 2.0 | Videos, Shorts | Yes | [View](/platforms/youtube#video-requirements) |
| [Pinterest](/platforms/pinterest) | OAuth 2.0 | Pins (Image/Video) | Yes | [View](/platforms/pinterest#image-requirements) |
| [Reddit](/platforms/reddit) | OAuth 2.0 | Text, Images, Videos, Links | Limited | [View](/platforms/reddit#image-requirements) |
| [Bluesky](/platforms/bluesky) | App Password | Text, Images, Videos | Limited | [View](/platforms/bluesky#image-requirements) |
| [Threads](/platforms/threads) | OAuth 2.0 | Text, Images, Videos | Yes | [View](/platforms/threads#image-requirements) |
| [Google Business](/platforms/google-business) | OAuth 2.0 | Updates, Photos | Yes | [View](/platforms/google-business#image-requirements) |
| [Telegram](/platforms/telegram) | Bot Token | Text, Images, Videos, Albums | No | [View](/platforms/telegram#media-requirements) |
| [Snapchat](/platforms/snapchat) | OAuth 2.0 | Stories, Saved Stories, Spotlight | Yes | [View](/platforms/snapchat#media-requirements) |
## Getting Started
### 1. Connect an Account
Each platform uses OAuth or platform-specific authentication. Start by connecting an account:
```bash
curl "https://getlate.dev/api/v1/connect/{platform}?profileId=YOUR_PROFILE_ID" \
-H "Authorization: Bearer YOUR_API_KEY"
```
Replace `{platform}` with: `twitter`, `instagram`, `facebook`, `linkedin`, `tiktok`, `youtube`, `pinterest`, `reddit`, `bluesky`, `threads`, `googlebusiness`, `telegram`, or `snapchat`.
### 2. Create a Post
Once connected, create posts targeting specific platforms:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Hello from Late API!",
"platforms": [
{"platform": "twitter", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
### 3. Cross-Post to Multiple Platforms
Post to multiple platforms simultaneously:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Cross-posting to all platforms!",
"platforms": [
{"platform": "twitter", "accountId": "acc_twitter"},
{"platform": "linkedin", "accountId": "acc_linkedin"},
{"platform": "bluesky", "accountId": "acc_bluesky"}
],
"publishNow": true
}'
```
## Platform-Specific Features
Each platform has unique capabilities:
- **Twitter/X** — Threads, polls, scheduled spaces
- **Instagram** — Stories, Reels, Carousels, Collaborators
- **Facebook** — Reels, Stories, Page posts
- **LinkedIn** — Documents (PDFs), Company pages, Personal profiles
- **TikTok** — Privacy settings, duet/stitch controls
- **YouTube** — Shorts, playlists, visibility settings
- **Pinterest** — Boards, Rich pins
- **Reddit** — Subreddits, flairs, NSFW tags
- **Bluesky** — Custom feeds, app passwords
- **Threads** — Reply controls
- **Google Business** — Location posts, offers, events
- **Telegram** — Channels, groups, silent messages, protected content
- **Snapchat** — Stories, Saved Stories, Spotlight, Public Profiles
## Analytics KPIs Matrix
Which metrics does the [Analytics API](/core/analytics) return for each platform?
| Platform | Impressions | Reach | Likes | Comments | Shares | Saves | Clicks | Views |
|----------|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
| Instagram | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | ✅ |
| Facebook | ✅ | — | ✅ | ✅ | ✅ | — | ✅ | ✅ |
| Twitter/X | ✅ | — | ✅ | ✅ | ✅ | — | ✅ | ✅ |
| LinkedIn | ✅ | ✅ | ✅ | ✅ | ✅ | — | ✅ | ✅\* |
| TikTok | — | — | ✅ | ✅ | ✅ | — | — | ✅ |
| YouTube | — | — | ✅ | ✅ | ✅\*\* | — | — | ✅ |
| Threads | ✅ | — | ✅ | ✅ | ✅ | — | — | ✅ |
| Bluesky | — | — | ✅ | ✅ | ✅ | — | — | — |
| Reddit | — | — | ✅ | ✅ | — | — | — | — |
| Pinterest | ✅ | — | — | — | — | ✅ | ✅ | — |
| Snapchat | — | ✅ | — | — | ✅ | — | — | ✅ |
| Telegram | — | — | — | — | — | — | — | — |
| Google Business | ✅ | — | — | — | — | — | ✅ | ✅ |
\* LinkedIn views only for video posts
\*\* YouTube shares only available via daily Analytics API, not basic Data API
## Inbox Feature Matrix
> **Requires [Inbox add-on](/pricing)** — $1/social set/month
The Inbox API provides a unified interface for managing DMs, comments, and reviews across all platforms.
### DMs Support
| Platform | List | Fetch | Send Text | Attachments | Quick Replies | Buttons | Edit | Archive |
|----------|------|-------|-----------|-------------|---------------|---------|------|---------|
| Facebook | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | ✅ |
| Instagram | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — | ✅ |
| Twitter/X | ✅ | ✅ | ✅ | ✅ | — | — | — | ❌ |
| Bluesky | ✅ | ✅ | ✅ | ❌ | — | — | — | ✅ |
| Reddit | ✅ | ✅ | ✅ | ❌ | — | — | — | ✅ |
| Telegram | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
### Comments Support
| Platform | List | Post | Reply | Delete | Like | Hide |
|----------|------|------|-------|--------|------|------|
| Facebook | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Instagram | ✅ | ❌ | ✅ | ✅ | ❌ | ✅ |
| Twitter/X | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| Bluesky | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| Threads | ✅ | ❌ | ✅ | ✅ | ❌ | ✅ |
| Reddit | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
| YouTube | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
| LinkedIn | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
| TikTok | ❌ | ✅ | ✅ | ✅ | ❌ | ❌ |
### Reviews Support
| Platform | List | Reply | Delete Reply |
|----------|------|-------|--------------|
| Facebook | ✅ | ✅ | ❌ |
| Google Business | ✅ | ✅ | ✅ |
### Webhooks
| Platform | `message.received` |
|----------|-------------------|
| Instagram | ✅ |
| Telegram | ✅ |
### Account Settings
| Platform | Feature | Endpoint |
|----------|---------|----------|
| Facebook | Persistent menu | `/v1/accounts/{accountId}/messenger-menu` |
| Instagram | Ice breakers | `/v1/accounts/{accountId}/instagram-ice-breakers` |
| Telegram | Bot commands | `/v1/accounts/{accountId}/telegram-commands` |
See [Account Settings](/core/account-settings) for full endpoint documentation.
### No Support
| Platform | Status | Notes |
|----------|--------|-------|
| Pinterest | No API | No inbox features available |
| Snapchat | No API | No inbox features available |
### Platform Limitations
| Platform | Limitation |
|----------|------------|
| Instagram | Reply-only comments, no comment likes (deprecated 2018) |
| Twitter/X | DMs require `dm.read` and `dm.write` scopes, no archive/unarchive, reply search cached (2-min TTL) |
| Bluesky | No DM attachments, like requires CID |
| Threads | No DMs, no comment likes, reply-only comments (no top-level), supports hide/unhide |
| Reddit | No DM attachments |
| Telegram | Bot-based, media limits (photos 10MB, videos 50MB) |
| YouTube | No DMs, no comment likes |
| LinkedIn | Org accounts only, no comment likes |
| TikTok | Cannot read comments (write-only) |
See [Messages](/core/messages), [Comments](/core/comments), and [Reviews](/core/reviews) API Reference for full endpoint documentation.
## API Reference
- [Connect Account](/core/connect) — OAuth flow for all platforms
- [Create Post](/core/posts) — Post creation and scheduling
- [Upload Media](/utilities/media) — Image and video uploads
- [Analytics](/core/analytics) — Post performance metrics
- [Messages](/core/messages), [Comments](/core/comments), and [Reviews](/core/reviews)
- [Account Settings](/core/account-settings) — Platform-specific messaging settings
---
# Instagram API
Post to Instagram with Late API - Feed posts, Stories, Reels, and Carousels
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
## Quick Start
Post to Instagram in under 60 seconds:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Check out this photo! 📸",
"mediaItems": [
{"type": "image", "url": "https://example.com/photo.jpg"}
],
"platforms": [
{"platform": "instagram", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Check out this photo! 📸',
mediaItems: [
{ type: 'image', url: 'https://example.com/photo.jpg' }
],
platforms: [
{ platform: 'instagram', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
const { post } = await response.json();
console.log('Posted to Instagram!', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Check out this photo! 📸',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/photo.jpg'}
],
'platforms': [
{'platform': 'instagram', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
post = response.json()['post']
print(f"Posted to Instagram! {post['_id']}")
```
> **Note:** Instagram requires media for all posts. Text-only posts are not supported.
## Content Types
Instagram supports multiple content types, each with different requirements:
| Type | Description | Media Required |
|------|-------------|----------------|
| **Feed Post** | Standard image/video post | Yes |
| **Carousel** | Multi-image/video post (up to 10) | Yes |
| **Story** | 24-hour ephemeral content | Yes |
| **Reel** | Short-form video (up to 90 sec) | Yes (video) |
## Image Requirements
| Property | Feed Post | Story | Carousel |
|----------|-----------|-------|----------|
| **Max Images** | 1 | 1 | 10 |
| **Formats** | JPEG, PNG | JPEG, PNG | JPEG, PNG |
| **Max File Size** | 8 MB | 8 MB | 8 MB each |
| **Recommended** | 1080 × 1350 px | 1080 × 1920 px | 1080 × 1080 px |
### Aspect Ratio Requirements
**This is critical for Instagram!** Feed posts have strict aspect ratio requirements:
| Orientation | Ratio | Dimensions | Use Case |
|-------------|-------|------------|----------|
| Portrait | 4:5 | 1080 × 1350 px | Best engagement |
| Square | 1:1 | 1080 × 1080 px | Standard |
| Landscape | 1.91:1 | 1080 × 566 px | Minimum |
**Allowed range:** 0.8 (4:5) to 1.91 (1.91:1)
```
✅ 4:5 (0.8) - Portrait
✅ 1:1 (1.0) - Square
✅ 1.91:1 (1.91) - Landscape
❌ 9:16 (0.56) - Too tall, use Story instead
❌ 16:9 (1.78) - Acceptable but cropped
```
> **Important:** Images outside the 0.8-1.91 range (like 9:16 vertical videos) must be posted as Stories using `contentType: "story"`.
## Video Requirements
### Feed Videos / Reels
| Property | Requirement |
|----------|-------------|
| **Formats** | MP4, MOV |
| **Max File Size** | 300 MB (auto-compressed if larger) |
| **Max Duration** | 90 seconds (Reels), 60 min (Feed) |
| **Min Duration** | 3 seconds |
| **Aspect Ratio** | 9:16 (Reels), 4:5 to 1.91:1 (Feed) |
| **Resolution** | 1080 × 1920 px (Reels) |
| **Frame Rate** | 30 fps recommended |
| **Codec** | H.264 |
### Story Videos
| Property | Requirement |
|----------|-------------|
| **Max File Size** | 100 MB (auto-compressed if larger) |
| **Max Duration** | 60 seconds |
| **Aspect Ratio** | 9:16 |
| **Resolution** | 1080 × 1920 px |
## Carousel Posts
Create carousel posts with up to **10 items** mixing images and videos:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Check out these photos from my trip! 🌴",
"mediaItems": [
{"type": "image", "url": "https://example.com/photo1.jpg"},
{"type": "image", "url": "https://example.com/photo2.jpg"},
{"type": "video", "url": "https://example.com/video.mp4"},
{"type": "image", "url": "https://example.com/photo3.jpg"}
],
"platforms": [
{"platform": "instagram", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Check out these photos from my trip! 🌴',
mediaItems: [
{ type: 'image', url: 'https://example.com/photo1.jpg' },
{ type: 'image', url: 'https://example.com/photo2.jpg' },
{ type: 'video', url: 'https://example.com/video.mp4' },
{ type: 'image', url: 'https://example.com/photo3.jpg' }
],
platforms: [
{ platform: 'instagram', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Check out these photos from my trip! 🌴',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/photo1.jpg'},
{'type': 'image', 'url': 'https://example.com/photo2.jpg'},
{'type': 'video', 'url': 'https://example.com/video.mp4'},
{'type': 'image', 'url': 'https://example.com/photo3.jpg'}
],
'platforms': [
{'platform': 'instagram', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
```
### Carousel Requirements
- All items should have the **same aspect ratio**
- First item determines the aspect ratio for all
- Mix of images and videos is allowed
- Each item: max 8 MB (images), 100 MB (videos)
## Stories
To post as a Story instead of feed:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mediaItems": [
{"type": "image", "url": "https://example.com/story-image.jpg"}
],
"platforms": [{
"platform": "instagram",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"contentType": "story"
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
mediaItems: [
{ type: 'image', url: 'https://example.com/story-image.jpg' }
],
platforms: [{
platform: 'instagram',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
contentType: 'story'
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/story-image.jpg'}
],
'platforms': [{
'platform': 'instagram',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'contentType': 'story'
}
}],
'publishNow': True
}
)
```
**Story Notes:**
- Stories disappear after 24 hours
- No text captions displayed (use image overlays)
- 9:16 aspect ratio recommended
> **Link Stickers:** Instagram's tappable link stickers for Stories are not available through the API. This is a limitation of Instagram's Graph API, not Late. To add link stickers, you'll need to post Stories directly through the Instagram app.
## Trial Reels
Trial Reels are initially shared only with non-followers, allowing you to test content performance before showing it to your audience. They can later be "graduated" to regular Reels visible to followers.
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mediaItems": [
{"type": "video", "url": "https://example.com/reel.mp4"}
],
"platforms": [{
"platform": "instagram",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"trialParams": {
"graduationStrategy": "SS_PERFORMANCE"
}
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
mediaItems: [
{ type: 'video', url: 'https://example.com/reel.mp4' }
],
platforms: [{
platform: 'instagram',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
trialParams: {
graduationStrategy: 'SS_PERFORMANCE'
}
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'mediaItems': [
{'type': 'video', 'url': 'https://example.com/reel.mp4'}
],
'platforms': [{
'platform': 'instagram',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'trialParams': {
'graduationStrategy': 'SS_PERFORMANCE'
}
}
}],
'publishNow': True
}
)
```
### Graduation Strategies
| Strategy | Description |
|----------|-------------|
| `MANUAL` | Trial Reel can only be graduated manually from the Instagram app |
| `SS_PERFORMANCE` | Trial Reel automatically graduates if it performs well with non-followers |
> **Note:** Trial Reels only apply to video posts (Reels). They cannot be used with images, carousels, or stories.
## Thumbnail Offset for Reels
You can specify a frame from your video to use as the Reel thumbnail by setting a millisecond offset from the start of the video:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Check out my new Reel! 🎬",
"mediaItems": [
{"type": "video", "url": "https://example.com/reel.mp4"}
],
"platforms": [{
"platform": "instagram",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"thumbOffset": 5000
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Check out my new Reel! 🎬',
mediaItems: [
{ type: 'video', url: 'https://example.com/reel.mp4' }
],
platforms: [{
platform: 'instagram',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
thumbOffset: 5000
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Check out my new Reel! 🎬',
'mediaItems': [
{'type': 'video', 'url': 'https://example.com/reel.mp4'}
],
'platforms': [{
'platform': 'instagram',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'thumbOffset': 5000
}
}],
'publishNow': True
}
)
```
| Property | Description |
|----------|-------------|
| `thumbOffset` | Millisecond offset from the start of the video (e.g., `5000` = 5 seconds) |
> **Note:** If you provide a custom thumbnail URL (`instagramThumbnail` in mediaItems), it takes priority over `thumbOffset`. The offset defaults to 0 (first frame) if not specified.
## Custom Cover Images for Reels
You can upload a custom cover image for your Instagram Reels instead of using a frame from the video. Use the `instagramThumbnail` parameter in your media item:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Check out my new Reel! 🎬",
"mediaItems": [
{
"type": "video",
"url": "https://example.com/reel.mp4",
"instagramThumbnail": "https://example.com/custom-cover.jpg"
}
],
"platforms": [
{"platform": "instagram", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Check out my new Reel! 🎬',
mediaItems: [
{
type: 'video',
url: 'https://example.com/reel.mp4',
instagramThumbnail: 'https://example.com/custom-cover.jpg'
}
],
platforms: [
{ platform: 'instagram', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Check out my new Reel! 🎬',
'mediaItems': [
{
'type': 'video',
'url': 'https://example.com/reel.mp4',
'instagramThumbnail': 'https://example.com/custom-cover.jpg'
}
],
'platforms': [
{'platform': 'instagram', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
```
### Cover Image Requirements
| Property | Requirement |
|----------|-------------|
| **Format** | JPEG, PNG |
| **Recommended Size** | 1080 × 1920 px (9:16) |
| **Aspect Ratio** | Should match your Reel (typically 9:16) |
> **Tip:** Custom cover images are great for adding text overlays, branded thumbnails, or eye-catching visuals that encourage viewers to watch your Reel.
## Collaborators
Invite up to 3 collaborators on feed posts and Reels:
```json
{
"platforms": [
{
"platform": "instagram",
"accountId": "acc_123",
"platformSpecificData": {
"collaborators": ["username1", "username2"]
}
}
]
}
```
## Audio Name
You can set a custom name for the original audio in Reels, replacing the default "Original Audio" label. This can only be set once during creation or later from the Instagram audio page in the app.
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mediaItems": [{"type": "video", "url": "https://example.com/reel.mp4"}],
"platforms": [{
"platform": "instagram",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"audioName": "My Podcast Intro"
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
mediaItems: [
{ type: 'video', url: 'https://example.com/reel.mp4' }
],
platforms: [{
platform: 'instagram',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
audioName: 'My Podcast Intro'
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'mediaItems': [
{'type': 'video', 'url': 'https://example.com/reel.mp4'}
],
'platforms': [
{
'platform': 'instagram',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'audioName': 'My Podcast Intro'
}
}
],
'publishNow': True
}
)
```
> **Note:** The audio name can only be set once and is applicable only for Reels (video posts).
## Automatic Compression
Late automatically compresses oversized media:
| Content Type | Image Limit | Video Limit | Action |
|--------------|-------------|-------------|--------|
| Feed/Carousel | 8 MB | 300 MB | Auto-compress |
| Story | 8 MB | 100 MB | Auto-compress |
| Reel | 8 MB | 300 MB | Auto-compress |
Original files are preserved.
## Common Issues
### "Invalid aspect ratio"
Your image is outside the 0.8-1.91 range. Solutions:
1. Crop to 4:5 or 1:1
2. Use `contentType: "story"` for 9:16 content
### Video rejected as Reel
Videos under 90 seconds with 9:16 aspect ratio automatically become Reels. If you want a feed video, use a different aspect ratio.
### Carousel items showing differently
Ensure all carousel items have the same aspect ratio. The first item sets the ratio for all.
## Inbox
> **Requires [Inbox add-on](/pricing)** — $1/social set/month
Instagram supports DMs and comments with some limitations.
### Direct Messages
| Feature | Supported |
|---------|-----------|
| List conversations | ✅ |
| Fetch messages | ✅ |
| Send text messages | ✅ |
| Send attachments | ✅ (images, videos, audio via URL) |
| Quick replies | ✅ (up to 13, Meta quick_replies) |
| Buttons | ✅ (up to 3, generic template) |
| Carousels | ✅ (generic template, up to 10 elements) |
| Message tags | ✅ (`HUMAN_AGENT` only) |
| Archive/unarchive | ✅ |
**Attachment limits:** 8 MB images, 25 MB video/audio. Attachments are automatically uploaded to temp storage and sent as URLs.
**Message tags:** Use `messageTag: "HUMAN_AGENT"` with `messagingType: "MESSAGE_TAG"` to send messages outside the 24-hour messaging window.
#### Instagram Profile Data
Instagram conversations include an optional `instagramProfile` object on participants and webhook senders, useful for routing and automation:
| Field | Type | Description |
|-------|------|-------------|
| `isFollower` | boolean | Whether the participant follows your business account |
| `isFollowing` | boolean | Whether your business account follows the participant |
| `followerCount` | integer | The participant's follower count |
| `isVerified` | boolean | Whether the participant is a verified Instagram user |
| `fetchedAt` | datetime | When this data was last fetched (conversations only) |
Available in:
- `GET /v1/inbox/conversations` and `GET /v1/inbox/conversations/{id}` — on each participant
- `message.received` webhook — on `message.sender`
### Ice Breakers
Manage ice breaker prompts shown when users start a new Instagram DM conversation. Max 4 ice breakers, question max 80 characters.
See [Account Settings](/core/account-settings) for the `GET/PUT/DELETE /v1/accounts/{accountId}/instagram-ice-breakers` endpoints.
### Comments
| Feature | Supported |
|---------|-----------|
| List comments on posts | ✅ |
| Post new top-level comment | ❌ (reply-only) |
| Reply to comments | ✅ |
| Delete comments | ✅ |
| Like comments | ❌ (deprecated since 2018) |
| Hide/unhide comments | ✅ |
### Webhooks
Subscribe to `message.received` to get notified when new DMs arrive. Messages are stored locally via webhooks.
### Limitations
- **Reply-only comments** — Cannot post new top-level comments, only replies to existing comments
- **No comment likes** — Liking comments was deprecated in 2018
See [Messages](/core/messages) and [Comments](/core/comments) API Reference for endpoint details.
## Related API Endpoints
- [Connect Instagram Account](/core/connect) — OAuth flow via Facebook Business
- [Create Post](/core/posts) — Post creation and scheduling
- [Upload Media](/utilities/media) — Image and video uploads
- [Analytics](/core/analytics) — Post performance metrics
- [Messages](/core/messages) and [Comments](/core/comments)
- [Account Settings](/core/account-settings) — Ice breakers configuration
---
# LinkedIn API
Post to LinkedIn with Late API - Personal profiles, Company pages, images, videos, and documents
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
## Quick Start
Post to LinkedIn in under 60 seconds:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Excited to share our latest update! 🚀\n\nWe have been working hard on this feature...",
"platforms": [
{"platform": "linkedin", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Excited to share our latest update! 🚀\n\nWe have been working hard on this feature...',
platforms: [
{ platform: 'linkedin', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
const { post } = await response.json();
console.log('Posted to LinkedIn!', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Excited to share our latest update! 🚀\n\nWe have been working hard on this feature...',
'platforms': [
{'platform': 'linkedin', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
post = response.json()['post']
print(f"Posted to LinkedIn! {post['_id']}")
```
## Image Requirements
| Property | Requirement |
|----------|-------------|
| **Max Images** | 20 per post |
| **Formats** | JPEG, PNG, GIF |
| **Max File Size** | 8 MB per image |
| **Recommended** | 1200 × 627 px |
| **Min Dimensions** | 552 × 276 px |
| **Max Dimensions** | 8192 × 8192 px |
### Aspect Ratios
| Type | Ratio | Dimensions | Use Case |
|------|-------|------------|----------|
| Landscape | 1.91:1 | 1200 × 627 px | Link shares, standard |
| Square | 1:1 | 1080 × 1080 px | Engagement |
| Portrait | 1:1.25 | 1080 × 1350 px | Mobile feed |
## Multi-Image Posts
LinkedIn supports up to **20 images** in carousel-style posts:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Highlights from our team retreat! 🏔️",
"mediaItems": [
{"type": "image", "url": "https://example.com/photo1.jpg"},
{"type": "image", "url": "https://example.com/photo2.jpg"},
{"type": "image", "url": "https://example.com/photo3.jpg"}
],
"platforms": [
{"platform": "linkedin", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Highlights from our team retreat! 🏔️',
mediaItems: [
{ type: 'image', url: 'https://example.com/photo1.jpg' },
{ type: 'image', url: 'https://example.com/photo2.jpg' },
{ type: 'image', url: 'https://example.com/photo3.jpg' }
],
platforms: [
{ platform: 'linkedin', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Highlights from our team retreat! 🏔️',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/photo1.jpg'},
{'type': 'image', 'url': 'https://example.com/photo2.jpg'},
{'type': 'image', 'url': 'https://example.com/photo3.jpg'}
],
'platforms': [
{'platform': 'linkedin', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
```
## Video Requirements
| Property | Requirement |
|----------|-------------|
| **Max Videos** | 1 per post |
| **Formats** | MP4, MOV, AVI |
| **Max File Size** | 5 GB |
| **Max Duration** | 15 minutes (personal), 30 min (Pages) |
| **Min Duration** | 3 seconds |
| **Resolution** | 256 × 144 px to 4096 × 2304 px |
| **Aspect Ratio** | 1:2.4 to 2.4:1 |
| **Frame Rate** | 10-60 fps |
### Recommended Video Specs
| Property | Recommended |
|----------|-------------|
| Resolution | 1920 × 1080 px (1080p) |
| Aspect Ratio | 16:9 (landscape) or 1:1 (square) |
| Frame Rate | 30 fps |
| Codec | H.264 |
| Audio | AAC, 192 kbps |
| Bitrate | 10-30 Mbps |
## Document Posts
LinkedIn uniquely supports **PDF documents**:
| Property | Requirement |
|----------|-------------|
| **Max Documents** | 1 per post |
| **Formats** | PDF, PPT, PPTX, DOC, DOCX |
| **Max File Size** | 100 MB |
| **Max Pages** | 300 pages |
Documents display as carousels users can swipe through:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Download our 2024 Industry Report 📊",
"mediaItems": [
{"type": "document", "url": "https://example.com/report.pdf"}
],
"platforms": [
{"platform": "linkedin", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Download our 2024 Industry Report 📊',
mediaItems: [
{ type: 'document', url: 'https://example.com/report.pdf' }
],
platforms: [
{ platform: 'linkedin', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Download our 2024 Industry Report 📊',
'mediaItems': [
{'type': 'document', 'url': 'https://example.com/report.pdf'}
],
'platforms': [
{'platform': 'linkedin', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
```
### Document Tips
- First page is the cover/preview
- Design for mobile viewing
- Keep text readable (large fonts)
- Ideal: 10-15 pages for engagement
## Multi-Organization Posting
If your connected LinkedIn account manages multiple organizations (company pages), you can post to different organizations from the same account connection.
### List Available Organizations
First, retrieve the list of organizations you can post to:
```bash
curl -X GET https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/linkedin-organizations \
-H "Authorization: Bearer YOUR_API_KEY"
```
```javascript
const response = await fetch(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/linkedin-organizations',
{
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
}
);
const organizations = await response.json();
console.log('Available organizations:', organizations);
```
```python
response = requests.get(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/linkedin-organizations',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
organizations = response.json()
print('Available organizations:', organizations)
```
### Post to Multiple Organizations
Use the same `accountId` multiple times with different `organizationUrn` values:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Exciting updates from our organization! 🚀",
"platforms": [
{
"platform": "linkedin",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"organizationUrn": "urn:li:organization:111111111"
}
},
{
"platform": "linkedin",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"organizationUrn": "urn:li:organization:222222222"
}
}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Exciting updates from our organization! 🚀',
platforms: [
{
platform: 'linkedin',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: { organizationUrn: 'urn:li:organization:111111111' }
},
{
platform: 'linkedin',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: { organizationUrn: 'urn:li:organization:222222222' }
}
],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Exciting updates from our organization! 🚀',
'platforms': [
{
'platform': 'linkedin',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {'organizationUrn': 'urn:li:organization:111111111'}
},
{
'platform': 'linkedin',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {'organizationUrn': 'urn:li:organization:222222222'}
}
],
'publishNow': True
}
)
```
> **Note:** The `organizationUrn` format is `urn:li:organization:` followed by the organization ID.
## Link Previews
When posting text with URLs and no media, LinkedIn auto-generates link previews:
```json
{
"content": "Check out our latest blog post! https://example.com/blog/new-post",
"platforms": [
{ "platform": "linkedin", "accountId": "acc_123" }
]
}
```
### Disable Link Preview
To post a URL without the preview card:
```json
{
"platforms": [
{
"platform": "linkedin",
"accountId": "acc_123",
"platformSpecificData": {
"disableLinkPreview": true
}
}
]
}
```
## First Comment
Add an automatic first comment:
```json
{
"platforms": [
{
"platform": "linkedin",
"accountId": "acc_123",
"platformSpecificData": {
"firstComment": "What do you think? Share your thoughts below! 👇"
}
}
]
}
```
## GIF Support
GIFs on LinkedIn:
- Converted to video format
- Auto-play in feed (muted)
- Max recommended: 10 MB
- Counts as video (1 per post limit)
## LinkedIn Articles (Long-Form)
LinkedIn's API does not support creating native long-form articles (the ones published at linkedin.com/article/new/). This is a LinkedIn platform limitation, not a Late limitation. The API only supports:
- Text posts
- Image posts
- Video posts
- Document uploads (PDF, PPT, DOC)
- Link previews (URL shared with rich metadata card)
- Multi-image posts
If your users need to publish long-form articles, they must do so directly through LinkedIn's web interface.
## Common Issues
### "Cannot mix media types"
LinkedIn doesn't allow images + videos or images + documents. Choose one type per post.
### Document not displaying
- Check file size (≤100 MB)
- Ensure valid format (PDF recommended)
- Password-protected PDFs won't work
### Video processing failed
- Ensure codec is H.264
- Check duration limits (15 min personal, 30 min Pages)
- Verify aspect ratio is between 1:2.4 and 2.4:1
### Link preview wrong image
The preview uses Open Graph meta tags from the URL. Update the `og:image` tag on your website.
## Inbox
> **Requires [Inbox add-on](/pricing)** — $1/social set/month
LinkedIn supports comments only (no DMs via API).
### Comments
| Feature | Supported |
|---------|-----------|
| List comments on posts | ✅ |
| Reply to comments | ✅ |
| Delete comments | ✅ |
| Like comments | ❌ (API restricted) |
### Limitations
- **No DMs** — LinkedIn's messaging API is not available for third-party apps
- **Organization accounts only** — Comments require an organization (company page) account type
- **No comment likes** — Reactions API is restricted to LinkedIn partners
See [Comments API Reference](/core/comments) for endpoint details.
## Related API Endpoints
- [Connect LinkedIn Account](/core/connect) — OAuth flow
- [Create Post](/core/posts) — Post creation and scheduling
- [Upload Media](/utilities/media) — Image and video uploads
- [LinkedIn Mentions](/utilities/linkedin-mentions) — Track mentions
- [Analytics](/core/analytics) — Post performance metrics
- [Comments](/core/comments)
---
# Pinterest API
Post to Pinterest with Late API - Pins, boards, and destination links
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
## Quick Start
Create a Pin on Pinterest:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "10 Tips for Better Photography 📸",
"mediaItems": [
{"type": "image", "url": "https://example.com/pin-image.jpg"}
],
"platforms": [{
"platform": "pinterest",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"title": "10 Tips for Better Photography",
"boardId": "YOUR_BOARD_ID",
"link": "https://myblog.com/photography-tips"
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: '10 Tips for Better Photography 📸',
mediaItems: [
{ type: 'image', url: 'https://example.com/pin-image.jpg' }
],
platforms: [{
platform: 'pinterest',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
title: '10 Tips for Better Photography',
boardId: 'YOUR_BOARD_ID',
link: 'https://myblog.com/photography-tips'
}
}],
publishNow: true
})
});
const { post } = await response.json();
console.log('Pin created!', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': '10 Tips for Better Photography 📸',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/pin-image.jpg'}
],
'platforms': [{
'platform': 'pinterest',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'title': '10 Tips for Better Photography',
'boardId': 'YOUR_BOARD_ID',
'link': 'https://myblog.com/photography-tips'
}
}],
'publishNow': True
}
)
post = response.json()['post']
print(f"Pin created! {post['_id']}")
```
## Overview
Pinterest Pins support either **one image** OR **one video** per Pin (not both).
## Image Requirements
| Property | Requirement |
|----------|-------------|
| **Max Images** | 1 per Pin |
| **Formats** | JPEG, PNG, WebP, GIF |
| **Max File Size** | 32 MB |
| **Recommended** | 1000 × 1500 px (2:3) |
| **Min Dimensions** | 100 × 100 px |
### Aspect Ratios
| Ratio | Dimensions | Use Case |
|-------|------------|----------|
| 2:3 | 1000 × 1500 px | **Optimal** - Standard Pin |
| 1:1 | 1000 × 1000 px | Square Pin |
| 1:2.1 | 1000 × 2100 px | Long Pin (max height) |
> **Best Practice:** Use 2:3 aspect ratio for optimal display in the Pinterest feed.
## Video Requirements
| Property | Requirement |
|----------|-------------|
| **Max Videos** | 1 per Pin |
| **Formats** | MP4, MOV |
| **Max File Size** | 2 GB |
| **Duration** | 4 seconds - 15 minutes |
| **Aspect Ratio** | 2:3, 1:1, or 9:16 |
| **Resolution** | 1080p recommended |
| **Frame Rate** | 25+ fps |
### Video Specs
| Property | Minimum | Recommended |
|----------|---------|-------------|
| Resolution | 240p | 1080p |
| Bitrate | - | 10 Mbps |
| Audio | - | AAC, 128 kbps |
### Video Pin Example
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Quick recipe tutorial 🍳",
"mediaItems": [
{"type": "video", "url": "https://example.com/recipe.mp4"}
],
"platforms": [{
"platform": "pinterest",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"title": "5-Minute Breakfast Recipe",
"boardId": "YOUR_BOARD_ID",
"link": "https://myrecipes.com/quick-breakfast"
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Quick recipe tutorial 🍳',
mediaItems: [
{ type: 'video', url: 'https://example.com/recipe.mp4' }
],
platforms: [{
platform: 'pinterest',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
title: '5-Minute Breakfast Recipe',
boardId: 'YOUR_BOARD_ID',
link: 'https://myrecipes.com/quick-breakfast'
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Quick recipe tutorial 🍳',
'mediaItems': [
{'type': 'video', 'url': 'https://example.com/recipe.mp4'}
],
'platforms': [{
'platform': 'pinterest',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'title': '5-Minute Breakfast Recipe',
'boardId': 'YOUR_BOARD_ID',
'link': 'https://myrecipes.com/quick-breakfast'
}
}],
'publishNow': True
}
)
```
## Video Cover Image
Add a custom cover for video Pins:
```json
{
"platformSpecificData": {
"coverImageUrl": "https://example.com/cover.jpg",
"coverImageKeyFrameTime": 5
}
}
```
| Property | Description |
|----------|-------------|
| `coverImageUrl` | Custom cover image URL |
| `coverImageKeyFrameTime` | Auto-extract frame at N seconds |
## Pin Title
| Property | Requirement |
|----------|-------------|
| Max Length | 100 characters |
| Default | First line of content |
| Fallback | "Pin" |
```json
{
"platformSpecificData": {
"title": "My Pin Title (max 100 chars)"
}
}
```
## Board Selection
Specify which board to pin to:
```json
{
"platformSpecificData": {
"boardId": "board_123456"
}
}
```
If omitted, the first available board is used.
### Get Board IDs
Use the Pinterest boards endpoint to list available boards for a connected account:
```bash
GET https://getlate.dev/api/v1/accounts/{accountId}/pinterest-boards
```
This returns a list of boards with their IDs that you can use in `platformSpecificData.boardId`.
## Destination Link
Add a clickable link to your Pin:
```json
{
"platformSpecificData": {
"link": "https://example.com/landing-page"
}
}
```
- Must be a valid URL
- Opens when users click the Pin
- Important for driving traffic
## GIF Support
Pinterest supports animated GIFs:
- Auto-play in feed
- Max 32 MB
- Treated as image (not video)
- Recommend keeping under 10 MB for fast loading
## Common Issues
### "Image too small"
Minimum dimensions are 100 × 100 px, but Pinterest recommends at least 600 px wide for good quality.
### Pin not showing in feed
- Pinterest may take time to index new Pins
- Ensure board is not secret/archived
- Check if account is in good standing
### Video processing failed
- Ensure format is MP4 or MOV
- Check duration (4 sec - 15 min)
- Verify file size (≤2 GB)
- Use H.264 codec
### Wrong aspect ratio display
Pinterest crops images to fit. Use 2:3 ratio for best results:
- 1000 × 1500 px
- 600 × 900 px (minimum)
### Link not clickable
- Ensure URL is valid and accessible
- Use `https://` (not `http://`)
- Avoid URL shorteners that may be blocked
## Inbox
Pinterest does not have inbox features available via API.
- **No DMs** — Pinterest's messaging API is not available for third-party apps
- **No comments** — Pin comments are not accessible via API
- **No reviews** — Pinterest does not have a reviews system
## Related API Endpoints
- [Connect Pinterest Account](/core/connect) — OAuth flow
- [Create Post](/core/posts) — Pin creation and scheduling
- [Upload Media](/utilities/media) — Image and video uploads
- [Pinterest Boards](/core/connect#list-pinterest-boards-for-a-connected-account) — List boards for an account
---
# Reddit API
Post to Reddit with Late API - Text posts, links, and image posts
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
## Quick Start
Create a post on Reddit:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "What is your favorite programming language and why?\n\nI have been using Python for years but considering learning Rust.",
"platforms": [
{"platform": "reddit", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: "What is your favorite programming language and why?\n\nI have been using Python for years but considering learning Rust.",
platforms: [
{ platform: 'reddit', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
const { post } = await response.json();
console.log('Posted to Reddit!', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': "What is your favorite programming language and why?\n\nI have been using Python for years but considering learning Rust.",
'platforms': [
{'platform': 'reddit', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
post = response.json()['post']
print(f"Posted to Reddit! {post['_id']}")
```
## Overview
Reddit API posting supports:
- ✅ Text posts
- ✅ Link posts
- ✅ Image posts (single image)
- ❌ Video posts (not supported via API)
## Image Requirements
| Property | Requirement |
|----------|-------------|
| **Max Images** | 1 per post |
| **Formats** | JPEG, PNG, GIF |
| **Max File Size** | 20 MB |
| **Recommended** | 1200 × 628 px |
### Aspect Ratios
Reddit is flexible with aspect ratios:
| Ratio | Use Case |
|-------|----------|
| 16:9 | Standard landscape |
| 4:3 | Classic format |
| 1:1 | Square images |
| 9:16 | Mobile screenshots |
## Image Post Example
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Check out this view from my hike!",
"mediaItems": [
{"type": "image", "url": "https://example.com/hiking-photo.jpg"}
],
"platforms": [
{"platform": "reddit", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Check out this view from my hike!',
mediaItems: [
{ type: 'image', url: 'https://example.com/hiking-photo.jpg' }
],
platforms: [
{ platform: 'reddit', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
const { post } = await response.json();
console.log('Posted to Reddit!', post._id);
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Check out this view from my hike!',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/hiking-photo.jpg'}
],
'platforms': [
{'platform': 'reddit', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
post = response.json()['post']
print(f"Posted to Reddit! {post['_id']}")
```
## Link Posts
Share a URL:
```json
{
"content": "Interesting article about AI",
"link": "https://example.com/article",
"platforms": [
{ "platform": "reddit", "accountId": "acc_123" }
]
}
```
**Note:** When a link is provided, Reddit creates a link post. The `content` becomes the post title.
## Subreddit Selection
Posts are submitted to the subreddit configured on the connected Reddit account by default.
To post to a specific subreddit per post, set `platformSpecificData.subreddit` (without the `r/` prefix).
## Post Flairs
Some subreddits require a post flair. To set one, pass `platformSpecificData.flairId` when creating the post.
First, list available flairs for a subreddit:
```bash
curl -X GET "https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/reddit-flairs?subreddit=socialmedia" \
-H "Authorization: Bearer YOUR_API_KEY"
```
```javascript
const response = await fetch(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/reddit-flairs?subreddit=socialmedia',
{
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data.flairs);
```
```python
import requests
response = requests.get(
'https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/reddit-flairs',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'subreddit': 'socialmedia'}
)
print(response.json()['flairs'])
```
Then, create a post with `flairId`:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "What is your favorite programming language and why?",
"platforms": [
{
"platform": "reddit",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"subreddit": "socialmedia",
"flairId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'What is your favorite programming language and why?',
platforms: [
{
platform: 'reddit',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
subreddit: 'socialmedia',
flairId: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
}
}
],
publishNow: true
})
});
const { post } = await response.json();
console.log('Posted to Reddit!', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'What is your favorite programming language and why?',
'platforms': [
{
'platform': 'reddit',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'subreddit': 'socialmedia',
'flairId': 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
}
}
],
'publishNow': True
}
)
post = response.json()['post']
print(f"Posted to Reddit! {post['_id']}")
```
> **Note:** If a subreddit requires a flair and you do not provide `flairId`, the API will attempt to use the first available flair as a fallback.
## GIF Support
Reddit supports animated GIFs:
- Static display until clicked
- Max 20 MB
- May convert to video format internally
- Keep under 10 MB for better performance
## Video Limitations
**Important:** Reddit's API does not support video uploads for third-party applications. This is a Reddit API limitation, not a Late limitation.
If you need to post videos to Reddit:
1. Upload to a video hosting service (YouTube, Imgur, etc.)
2. Create a link post with the video URL
## Formatting Tips
Reddit supports Markdown in text posts:
```markdown
# Heading
**Bold text**
*Italic text*
- Bullet points
1. Numbered lists
[Link text](https://example.com)
> Block quotes
`inline code`
```
## Common Issues
### "Post rejected by subreddit"
Each subreddit has rules:
- Some require flair (set `platformSpecificData.flairId`; use `GET /v1/accounts/{accountId}/reddit-flairs?subreddit=name` to list options)
- Some don't allow images
- Some have karma requirements
- Check r/subreddit rules
### "Rate limited"
Reddit has strict rate limits:
- ~10 posts per day for new accounts
- Higher limits for established accounts
- Wait between posts
### Image not displaying
- Check file size (≤20 MB)
- Ensure valid format (JPEG, PNG, GIF)
- Verify URL is publicly accessible
### "Video not supported"
Reddit API doesn't support video uploads. Use a link post with a video URL instead.
### Post removed
Moderators may remove posts for:
- Breaking subreddit rules
- Spam detection
- Missing required flair
- Low karma accounts
## Inbox
> **Requires [Inbox add-on](/pricing)** — $1/social set/month
Reddit supports DMs (private messages) and comments.
### Direct Messages
| Feature | Supported |
|---------|-----------|
| List conversations | ✅ |
| Fetch messages | ✅ |
| Send text messages | ✅ |
| Send attachments | ❌ (API limitation) |
| Archive/unarchive | ✅ |
### Comments
| Feature | Supported |
|---------|-----------|
| List comments on posts | ✅ |
| Reply to comments | ✅ |
| Delete comments | ✅ |
| Upvote/downvote | ✅ |
| Remove vote | ✅ |
### Limitations
- **No DM attachments** — Reddit's API does not support media in private messages
- **Subreddit required** — When replying to comments, you must provide the `subreddit` parameter
See [Messages](/core/messages) and [Comments](/core/comments) API Reference for endpoint details.
## Related API Endpoints
- [Connect Reddit Account](/core/connect) — OAuth flow
- [Create Post](/core/posts) — Post creation and scheduling
- [Upload Media](/utilities/media) — Image uploads
- [Reddit Search](/utilities/reddit-search) — Search Reddit content
- [Messages](/core/messages) and [Comments](/core/comments)
---
# Snapchat API
Post to Snapchat with Late API - Stories, Saved Stories, and Spotlight content
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
## Quick Start
Post to Snapchat in under 60 seconds:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mediaItems": [
{"type": "video", "url": "https://example.com/video.mp4"}
],
"platforms": [{
"platform": "snapchat",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"contentType": "story"
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
mediaItems: [
{ type: 'video', url: 'https://example.com/video.mp4' }
],
platforms: [{
platform: 'snapchat',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
contentType: 'story'
}
}],
publishNow: true
})
});
const { post } = await response.json();
console.log('Posted to Snapchat!', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'mediaItems': [
{'type': 'video', 'url': 'https://example.com/video.mp4'}
],
'platforms': [{
'platform': 'snapchat',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'contentType': 'story'
}
}],
'publishNow': True
}
)
post = response.json()['post']
print(f"Posted to Snapchat! {post['_id']}")
```
## Overview
Snapchat supports three content types through the Public Profile API: Stories, Saved Stories, and Spotlight. A Public Profile is required to publish content via the API.
| Feature | Support |
|---------|---------|
| Stories | Ephemeral content (24 hours) |
| Saved Stories | Permanent content on Public Profile |
| Spotlight | Video feed (similar to TikTok) |
| Text-only posts | Not supported |
| Scheduling | Yes |
| Analytics | Views, screenshots, shares, completion rate |
## Content Types
Snapchat offers three distinct content types:
| Type | Description | Duration | Caption Support |
|------|-------------|----------|-----------------|
| `story` | Ephemeral snap visible for 24 hours | Temporary | No caption |
| `saved_story` | Permanent story on Public Profile | Permanent | Title (max 45 chars) |
| `spotlight` | Video in Snapchat's entertainment feed | Permanent | Description (max 160 chars) |
## Media Requirements
**Important:** Media is required for all Snapchat posts. Text-only posts are not supported.
### Images
| Property | Requirement |
|----------|-------------|
| **Formats** | JPEG, PNG |
| **Max File Size** | 20 MB |
| **Recommended Dimensions** | 1080 × 1920 px |
| **Aspect Ratio** | 9:16 (portrait) |
### Videos
| Property | Requirement |
|----------|-------------|
| **Format** | MP4 |
| **Max File Size** | 500 MB |
| **Duration** | 5-60 seconds |
| **Min Resolution** | 540 × 960 px |
| **Recommended Dimensions** | 1080 × 1920 px |
| **Aspect Ratio** | 9:16 (portrait) |
> **Note:** Media is automatically encrypted using AES-256-CBC before upload to Snapchat.
## Story Posts
Stories are ephemeral content visible for 24 hours. No caption or text is supported.
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mediaItems": [
{"type": "image", "url": "https://example.com/image.jpg"}
],
"platforms": [{
"platform": "snapchat",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"contentType": "story"
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
mediaItems: [
{ type: 'image', url: 'https://example.com/image.jpg' }
],
platforms: [{
platform: 'snapchat',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
contentType: 'story'
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/image.jpg'}
],
'platforms': [{
'platform': 'snapchat',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'contentType': 'story'
}
}],
'publishNow': True
}
)
```
## Saved Story Posts
Saved Stories are permanent content displayed on your Public Profile. The post `content` is used as the title (max 45 characters).
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Behind the scenes look!",
"mediaItems": [
{"type": "video", "url": "https://example.com/video.mp4"}
],
"platforms": [{
"platform": "snapchat",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"contentType": "saved_story"
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Behind the scenes look!',
mediaItems: [
{ type: 'video', url: 'https://example.com/video.mp4' }
],
platforms: [{
platform: 'snapchat',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
contentType: 'saved_story'
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Behind the scenes look!',
'mediaItems': [
{'type': 'video', 'url': 'https://example.com/video.mp4'}
],
'platforms': [{
'platform': 'snapchat',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'contentType': 'saved_story'
}
}],
'publishNow': True
}
)
```
## Spotlight Posts
Spotlight is Snapchat's TikTok-like entertainment feed. Only video content is supported. The post `content` is used as the description (max 160 characters) and can include hashtags.
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Check out this amazing sunset! #sunset #nature #viral",
"mediaItems": [
{"type": "video", "url": "https://example.com/sunset-video.mp4"}
],
"platforms": [{
"platform": "snapchat",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"contentType": "spotlight"
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Check out this amazing sunset! #sunset #nature #viral',
mediaItems: [
{ type: 'video', url: 'https://example.com/sunset-video.mp4' }
],
platforms: [{
platform: 'snapchat',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
contentType: 'spotlight'
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Check out this amazing sunset! #sunset #nature #viral',
'mediaItems': [
{'type': 'video', 'url': 'https://example.com/sunset-video.mp4'}
],
'platforms': [{
'platform': 'snapchat',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'contentType': 'spotlight'
}
}],
'publishNow': True
}
)
```
## Connect a Snapchat Account
Snapchat uses OAuth for authentication and requires selecting a Public Profile to publish content.
### Standard Flow
Redirect users to the Late OAuth URL:
```
https://getlate.dev/connect/snapchat?profileId=YOUR_PROFILE_ID&redirect_url=https://yourapp.com/callback
```
After authorization, users select a Public Profile, and Late redirects back to your `redirect_url` with connection details.
### Headless Mode (Custom UI)
Build your own fully-branded Public Profile selector:
#### Step 1: Initiate OAuth
```
https://getlate.dev/api/v1/connect/snapchat?profileId=YOUR_PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true
```
After OAuth, you'll be redirected to your `redirect_url` with:
- `tempToken` - Temporary access token
- `userProfile` - URL-encoded JSON with user info
- `publicProfiles` - URL-encoded JSON array of available Public Profiles
- `connect_token` - Short-lived token for API authentication
- `platform=snapchat`
- `step=select_public_profile`
#### Step 2: List Public Profiles
```bash
curl -X GET "https://getlate.dev/api/v1/connect/snapchat/select-profile?profileId=YOUR_PROFILE_ID&tempToken=TEMP_TOKEN" \
-H "X-Connect-Token: CONNECT_TOKEN"
```
```javascript
const response = await fetch(
`https://getlate.dev/api/v1/connect/snapchat/select-profile?profileId=${profileId}&tempToken=${tempToken}`,
{
headers: { 'X-Connect-Token': connectToken }
}
);
const { publicProfiles } = await response.json();
// Display profiles in your custom UI
```
```python
response = requests.get(
'https://getlate.dev/api/v1/connect/snapchat/select-profile',
params={'profileId': 'YOUR_PROFILE_ID', 'tempToken': temp_token},
headers={'X-Connect-Token': connect_token}
)
public_profiles = response.json()['publicProfiles']
# Display profiles in your custom UI
```
**Response:**
```json
{
"publicProfiles": [
{
"id": "abc123-def456",
"display_name": "My Brand",
"username": "mybrand",
"profile_image_url": "https://cf-st.sc-cdn.net/...",
"subscriber_count": 15000
},
{
"id": "xyz789-uvw012",
"display_name": "Side Project",
"username": "sideproject",
"profile_image_url": "https://cf-st.sc-cdn.net/...",
"subscriber_count": 5000
}
]
}
```
#### Step 3: Select Public Profile
```bash
curl -X POST https://getlate.dev/api/v1/connect/snapchat/select-profile \
-H "X-Connect-Token: CONNECT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"profileId": "YOUR_LATE_PROFILE_ID",
"selectedPublicProfile": {
"id": "abc123-def456",
"display_name": "My Brand",
"username": "mybrand"
},
"tempToken": "TEMP_TOKEN",
"userProfile": {
"id": "user123",
"username": "mybrand",
"displayName": "My Brand"
}
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/connect/snapchat/select-profile', {
method: 'POST',
headers: {
'X-Connect-Token': connectToken,
'Content-Type': 'application/json'
},
body: JSON.stringify({
profileId: 'YOUR_LATE_PROFILE_ID',
selectedPublicProfile: {
id: 'abc123-def456',
display_name: 'My Brand',
username: 'mybrand'
},
tempToken: tempToken,
userProfile: userProfile
})
});
const { account } = await response.json();
console.log('Connected:', account._id);
```
```python
response = requests.post(
'https://getlate.dev/api/v1/connect/snapchat/select-profile',
headers={
'X-Connect-Token': connect_token,
'Content-Type': 'application/json'
},
json={
'profileId': 'YOUR_LATE_PROFILE_ID',
'selectedPublicProfile': {
'id': 'abc123-def456',
'display_name': 'My Brand',
'username': 'mybrand'
},
'tempToken': temp_token,
'userProfile': user_profile
}
)
account = response.json()['account']
print(f"Connected: {account['_id']}")
```
**Response:**
```json
{
"message": "Snapchat connected successfully with public profile",
"account": {
"platform": "snapchat",
"username": "mybrand",
"displayName": "My Brand",
"profilePicture": "https://cf-st.sc-cdn.net/...",
"isActive": true,
"publicProfileName": "My Brand"
}
}
```
## Platform-Specific Options
| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `contentType` | string | `story` | Content type: `story`, `saved_story`, or `spotlight` |
## Caption/Title Limits
| Content Type | Text Field | Limit |
|--------------|------------|-------|
| Story | N/A | No text supported |
| Saved Story | Title | 45 characters |
| Spotlight | Description | 160 characters (hashtags supported) |
## Analytics
Snapchat provides analytics for your content. Available metrics include:
| Metric | Description |
|--------|-------------|
| Views | Total number of views |
| Unique Viewers | Number of unique users who viewed |
| Screenshots | Number of screenshots taken |
| Shares | Number of times shared |
| Completion Rate | Percentage of viewers who watched to the end |
Analytics are fetched per content type (story, saved_story, spotlight).
## Common Issues
### "Public Profile required"
Snapchat requires a Public Profile to publish content via the API. During the connection flow, you must select a Public Profile to use.
### "Media is required"
Snapchat does not support text-only posts. All posts must include either an image or video.
### "Only one media item supported"
Snapchat only supports single media items per post. Carousels or albums are not supported.
### Video rejected
- Check duration (must be 5-60 seconds)
- Verify format (MP4 required)
- Ensure minimum resolution (540 × 960 px)
- Confirm file size is under 500 MB
### "Title too long" (Saved Stories)
Saved Story titles are limited to 45 characters. Truncate your content or use a shorter title.
### "Description too long" (Spotlight)
Spotlight descriptions are limited to 160 characters including hashtags.
## Inbox
Snapchat does not have inbox features available via API.
- **No DMs** — Snapchat's messaging API is not available for third-party apps
- **No comments** — Snap comments are not accessible via API
## Related API Endpoints
- [Connect Snapchat Account](/core/connect) — OAuth connection flow
- [Create Post](/core/posts) — Post creation and scheduling
- [Upload Media](/utilities/media) — Image and video uploads
- [Analytics](/core/analytics) — Fetch post analytics
---
# Telegram API
Post to Telegram channels and groups with Late API - Text, images, videos, and media albums
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
## Quick Start
Post to a Telegram channel or group:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Hello from Late API! Check out our latest update.",
"platforms": [
{"platform": "telegram", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Hello from Late API! Check out our latest update.',
platforms: [
{ platform: 'telegram', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
const { post } = await response.json();
console.log('Posted to Telegram!', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Hello from Late API! Check out our latest update.',
'platforms': [
{'platform': 'telegram', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
post = response.json()['post']
print(f"Posted to Telegram! {post['_id']}")
```
## Connect a Telegram Account
Late provides a managed bot (`@LateScheduleBot`) for Telegram integration. No need to create your own bot - just add Late's bot to your channel or group.
### Option 1: Access Code Flow (Recommended)
This is the easiest way to connect a Telegram channel or group.
#### Step 1: Generate an Access Code
```bash
curl -X GET "https://getlate.dev/api/v1/connect/telegram?profileId=YOUR_PROFILE_ID" \
-H "Authorization: Bearer YOUR_API_KEY"
```
```javascript
const response = await fetch(
'https://getlate.dev/api/v1/connect/telegram?profileId=YOUR_PROFILE_ID',
{
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
}
);
const { code, botUsername, instructions } = await response.json();
console.log(`Your access code: ${code}`);
console.log(`Bot to message: @${botUsername}`);
```
```python
response = requests.get(
'https://getlate.dev/api/v1/connect/telegram',
params={'profileId': 'YOUR_PROFILE_ID'},
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
data = response.json()
print(f"Your access code: {data['code']}")
print(f"Bot to message: @{data['botUsername']}")
```
**Response:**
```json
{
"code": "LATE-ABC123",
"expiresAt": "2025-01-15T12:30:00.000Z",
"expiresIn": 900,
"botUsername": "LateScheduleBot",
"instructions": [
"1. Add @LateScheduleBot as an administrator in your channel/group",
"2. Open a private chat with @LateScheduleBot",
"3. Send: LATE-ABC123 @yourchannel (replace @yourchannel with your channel username)",
"4. Wait for confirmation - the connection will appear in your dashboard",
"Tip: If your channel has no public username, forward a message from it along with the code"
]
}
```
#### Step 2: Add the Bot to Your Channel/Group
**For Channels:**
1. Go to your channel settings
2. Add `@LateScheduleBot` as an **Administrator**
3. Grant permission to **Post Messages**
**For Groups:**
1. Add `@LateScheduleBot` to the group
2. Make the bot an **Administrator** (required for posting)
#### Step 3: Send the Access Code
1. Open a private chat with [@LateScheduleBot](https://t.me/LateScheduleBot)
2. Send your access code with your channel: `LATE-ABC123 @yourchannel`
3. For private channels without a username, forward any message from the channel to the bot along with the code
#### Step 4: Poll for Connection Status
```bash
curl -X PATCH "https://getlate.dev/api/v1/connect/telegram?code=LATE-ABC123" \
-H "Authorization: Bearer YOUR_API_KEY"
```
```javascript
// Poll every 3 seconds until connected
const checkStatus = async (code) => {
const response = await fetch(
`https://getlate.dev/api/v1/connect/telegram?code=${code}`,
{
method: 'PATCH',
headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
}
);
return response.json();
};
// Example polling loop
const pollConnection = async (code) => {
while (true) {
const status = await checkStatus(code);
if (status.status === 'connected') {
console.log(`Connected to ${status.chatTitle}!`);
console.log(`Account ID: ${status.account._id}`);
return status.account;
}
if (status.status === 'expired') {
throw new Error('Access code expired. Generate a new one.');
}
// Wait 3 seconds before next check
await new Promise(resolve => setTimeout(resolve, 3000));
}
};
```
```python
import time
def check_status(code):
response = requests.patch(
'https://getlate.dev/api/v1/connect/telegram',
params={'code': code},
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
return response.json()
# Poll until connected
def poll_connection(code):
while True:
status = check_status(code)
if status['status'] == 'connected':
print(f"Connected to {status['chatTitle']}!")
print(f"Account ID: {status['account']['_id']}")
return status['account']
if status['status'] == 'expired':
raise Exception('Access code expired. Generate a new one.')
time.sleep(3) # Wait 3 seconds
```
**Status Response (Pending):**
```json
{
"status": "pending",
"expiresAt": "2025-01-15T12:30:00.000Z",
"expiresIn": 542
}
```
**Status Response (Connected):**
```json
{
"status": "connected",
"chatId": "-1001234567890",
"chatTitle": "My Channel",
"chatType": "channel",
"account": {
"_id": "64e1f0a9e2b5af0012ab34cd",
"platform": "telegram",
"username": "mychannel",
"displayName": "My Channel"
}
}
```
### Option 2: Direct Connection (Power Users)
If you already know your chat ID and the Late bot is already an administrator in your channel/group:
```bash
curl -X POST https://getlate.dev/api/v1/connect/telegram \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"profileId": "YOUR_PROFILE_ID",
"chatId": "-1001234567890"
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/connect/telegram', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
profileId: 'YOUR_PROFILE_ID',
chatId: '-1001234567890' // or '@mychannel' for public channels
})
});
const { account } = await response.json();
console.log('Connected:', account._id);
```
```python
response = requests.post(
'https://getlate.dev/api/v1/connect/telegram',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'profileId': 'YOUR_PROFILE_ID',
'chatId': '-1001234567890' # or '@mychannel' for public channels
}
)
data = response.json()
print(f"Connected: {data['account']['_id']}")
```
**Response:**
```json
{
"message": "Telegram channel connected successfully",
"account": {
"_id": "64e1f0a9e2b5af0012ab34cd",
"platform": "telegram",
"username": "mychannel",
"displayName": "My Channel",
"isActive": true,
"chatType": "channel"
}
}
```
### Finding Your Chat ID
**For Public Channels:**
- Use the channel username with `@` prefix: `@mychannel`
**For Private Channels:**
- Forward a message from the channel to [@userinfobot](https://t.me/userinfobot)
- The bot will reply with the numeric chat ID (starts with `-100`)
**For Groups:**
- Add [@userinfobot](https://t.me/userinfobot) to your group temporarily
- It will display the group's chat ID (negative number)
- Remove the bot after getting the ID
## Overview
Telegram supports text messages, images, videos, and mixed media albums. Posts can be sent to channels or groups where the Late bot has posting permissions.
| Feature | Support |
|---------|---------|
| Text posts | Up to 4096 characters |
| Media captions | Up to 1024 characters |
| Images | Up to 10 per album |
| Videos | Up to 10 per album |
| Mixed media | Images and videos in same album |
| Scheduling | Yes |
| Analytics | Not available (platform limitation) |
## Media Requirements
### Images
| Property | Requirement |
|----------|-------------|
| **Max Images** | 10 per album |
| **Formats** | JPEG, PNG, GIF, WebP |
| **Max File Size** | 10 MB |
| **Max Resolution** | 10000 × 10000 px |
### Videos
| Property | Requirement |
|----------|-------------|
| **Max Videos** | 10 per album |
| **Formats** | MP4, MOV |
| **Max File Size** | 50 MB |
| **Max Duration** | No limit |
| **Codec** | H.264 recommended |
## Platform-Specific Options
Telegram supports several message options:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Important Update!\n\nCheck out our new feature.",
"platforms": [{
"platform": "telegram",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"parseMode": "HTML",
"disableWebPagePreview": false,
"disableNotification": false,
"protectContent": false
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Important Update!\n\nCheck out our new feature.',
platforms: [{
platform: 'telegram',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
parseMode: 'HTML',
disableWebPagePreview: false,
disableNotification: false,
protectContent: false
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Important Update!\n\nCheck out our new feature.',
'platforms': [{
'platform': 'telegram',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'parseMode': 'HTML',
'disableWebPagePreview': False,
'disableNotification': False,
'protectContent': False
}
}],
'publishNow': True
}
)
```
### Available Options
| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `parseMode` | string | `HTML` | Text formatting mode: `HTML`, `Markdown`, or `MarkdownV2` |
| `disableWebPagePreview` | boolean | `false` | Disable link preview generation for URLs |
| `disableNotification` | boolean | `false` | Send message silently (no notification sound) |
| `protectContent` | boolean | `false` | Prevent message from being forwarded or saved |
## Text Formatting
### HTML Mode (Default)
```html
bold
italic
underline
strikethrough
inline code
code block
link
```
### Markdown Mode
```markdown
*bold*
_italic_
[link](https://example.com)
`inline code`
```
### MarkdownV2 Mode
```markdown
*bold*
_italic_
__underline__
~strikethrough~
||spoiler||
`inline code`
```
> **Note:** MarkdownV2 requires escaping special characters: `_`, `*`, `[`, `]`, `(`, `)`, `~`, `` ` ``, `>`, `#`, `+`, `-`, `=`, `|`, `{`, `}`, `.`, `!`
## Posting with Media
### Single Image
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Check out this photo!",
"mediaItems": [
{"type": "image", "url": "https://example.com/image.jpg"}
],
"platforms": [
{"platform": "telegram", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Check out this photo!',
mediaItems: [
{ type: 'image', url: 'https://example.com/image.jpg' }
],
platforms: [
{ platform: 'telegram', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Check out this photo!',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/image.jpg'}
],
'platforms': [
{'platform': 'telegram', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
```
### Media Album (Multiple Images/Videos)
```json
{
"content": "Our latest product gallery!",
"mediaItems": [
{"type": "image", "url": "https://example.com/image1.jpg"},
{"type": "image", "url": "https://example.com/image2.jpg"},
{"type": "video", "url": "https://example.com/video.mp4"},
{"type": "image", "url": "https://example.com/image3.jpg"}
],
"platforms": [
{"platform": "telegram", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}
```
> **Note:** Media albums support up to 10 items. Images and videos can be mixed in the same album.
## Channel vs Group Posts
| Destination | Author Display |
|-------------|----------------|
| **Channel** | Channel name and logo |
| **Group** | Bot name (LateScheduleBot) |
When posting to a **channel**, the post appears as if sent by the channel itself. When posting to a **group**, the post shows as sent by the Late bot.
## Character Limits
| Content Type | Limit |
|--------------|-------|
| Text-only messages | 4096 characters |
| Media captions | 1024 characters |
## Silent Messages
Send messages without triggering notification sounds:
```json
{
"content": "Late night update - didn't want to wake anyone!",
"platforms": [{
"platform": "telegram",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"disableNotification": true
}
}]
}
```
## Protected Content
Prevent users from forwarding or saving your content:
```json
{
"content": "Exclusive content for channel members only!",
"platforms": [{
"platform": "telegram",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"protectContent": true
}
}]
}
```
## Analytics Limitations
> **Important:** Telegram analytics are **not available via API**. The Telegram Bot API does not expose message analytics (views, forwards, reactions).
- View counts are only visible to channel admins directly in the Telegram app
- This is a Telegram platform limitation that affects all third-party tools
- Message IDs are returned for tracking purposes
## Common Issues
### "Bot is not a member of the channel"
- Ensure `@LateScheduleBot` is added to the channel/group as an administrator
- Grant the bot permission to post messages
### "Message is too long"
- Text-only messages: max 4096 characters
- Media captions: max 1024 characters
- Split long content into multiple messages
### "Wrong file identifier/HTTP URL specified"
- Ensure media URLs are publicly accessible
- Use HTTPS URLs
- Check that the URL directly points to the file (no redirects)
### "Can't parse entities"
- Check your HTML/Markdown syntax
- Ensure special characters are properly escaped in MarkdownV2
- Verify all tags are properly closed in HTML mode
### Media not displaying
- Verify file format is supported
- Check file size limits (10 MB for images, 50 MB for videos)
- Ensure the URL is publicly accessible without authentication
### "Access code expired"
- Access codes are valid for 15 minutes
- Generate a new code with `GET /v1/connect/telegram`
## Inbox
> **Requires [Inbox add-on](/pricing)** — $1/social set/month
Telegram supports DMs with full attachment support.
### Direct Messages
| Feature | Supported |
|---------|-----------|
| List conversations | ✅ |
| Fetch messages | ✅ |
| Send text messages | ✅ |
| Send attachments | ✅ (images, videos, documents) |
| Edit messages | ✅ (text and inline keyboard) |
| Inline keyboards | ✅ (buttons with callback data or URLs) |
| Reply keyboards | ✅ (one-time custom keyboards) |
| Reply to message | ✅ (via `replyTo` message ID) |
| Archive/unarchive | ✅ |
### Attachment Support
| Type | Supported | Max Size |
|------|-----------|----------|
| Images | ✅ | 10 MB |
| Videos | ✅ | 50 MB |
| Documents | ✅ | 50 MB |
### Bot Commands
Manage the bot command menu shown in Telegram chats. Commands appear in the "/" menu when users interact with the bot.
See [Account Settings](/core/account-settings) for the `GET/PUT/DELETE /v1/accounts/{accountId}/telegram-commands` endpoints.
### Webhooks
Subscribe to `message.received` to get notified when new DMs arrive. Messages are stored locally via webhooks.
### Notes
- **Bot-based** — Uses bot tokens, not OAuth
- Messages are stored locally when received via webhooks
- Incoming callback data from inline keyboard taps is available in message `metadata.callbackData`
See [Messages API Reference](/core/messages) for endpoint details.
## Related API Endpoints
- [Connect Telegram Account](/core/connect) — Access code connection flow
- [Create Post](/core/posts) — Post creation and scheduling
- [Upload Media](/utilities/media) — Image and video uploads
- [Messages](/core/messages)
- [Account Settings](/core/account-settings) — Bot commands configuration
---
# Threads API
Post to Threads with Late API - Text, images, videos, and thread sequences
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
## Quick Start
Post to Threads in under 60 seconds:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Sharing some thoughts on building in public 🚀",
"platforms": [
{"platform": "threads", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Sharing some thoughts on building in public 🚀',
platforms: [
{ platform: 'threads', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
const { post } = await response.json();
console.log('Posted to Threads!', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Sharing some thoughts on building in public 🚀',
'platforms': [
{'platform': 'threads', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
post = response.json()['post']
print(f"Posted to Threads! {post['_id']}")
```
## Overview
Threads (by Meta) supports images, videos, and thread sequences (multiple connected posts).
## Image Requirements
| Property | Requirement |
|----------|-------------|
| **Max Images** | 20 per post |
| **Formats** | JPEG, PNG, WebP, GIF |
| **Max File Size** | 8 MB per image |
| **Recommended** | 1080 × 1350 px (4:5) |
### Aspect Ratios
| Ratio | Dimensions | Notes |
|-------|------------|-------|
| 4:5 | 1080 × 1350 px | Portrait, recommended |
| 1:1 | 1080 × 1080 px | Square |
| 16:9 | 1080 × 608 px | Landscape |
## Image Post Example
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Sharing some thoughts on building in public 🚀",
"mediaItems": [
{"type": "image", "url": "https://example.com/photo1.jpg"},
{"type": "image", "url": "https://example.com/photo2.jpg"}
],
"platforms": [
{"platform": "threads", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Sharing some thoughts on building in public 🚀',
mediaItems: [
{ type: 'image', url: 'https://example.com/photo1.jpg' },
{ type: 'image', url: 'https://example.com/photo2.jpg' }
],
platforms: [
{ platform: 'threads', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Sharing some thoughts on building in public 🚀',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/photo1.jpg'},
{'type': 'image', 'url': 'https://example.com/photo2.jpg'}
],
'platforms': [
{'platform': 'threads', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
```
## Video Requirements
| Property | Requirement |
|----------|-------------|
| **Max Videos** | 1 per post |
| **Formats** | MP4, MOV |
| **Max File Size** | 1 GB |
| **Max Duration** | 5 minutes |
| **Min Duration** | 0 seconds |
| **Aspect Ratio** | 9:16 (vertical), 16:9 (landscape), 1:1 |
| **Resolution** | 1080p recommended |
### Recommended Video Specs
| Property | Recommended |
|----------|-------------|
| Resolution | 1080 × 1920 px (vertical) |
| Frame Rate | 30 fps |
| Codec | H.264 |
| Audio | AAC, 128 kbps |
## Thread Sequences
Create connected posts (root + replies):
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"platforms": [{
"platform": "threads",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"threadItems": [
{
"content": "Here is a thread about API design 🧵",
"mediaItems": [{"type": "image", "url": "https://example.com/cover.jpg"}]
},
{
"content": "1/ First, let us talk about REST principles..."
},
{
"content": "2/ Authentication is crucial. Here is what we recommend...",
"mediaItems": [{"type": "image", "url": "https://example.com/auth-diagram.jpg"}]
},
{
"content": "3/ Finally, always version your API! /end"
}
]
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
platforms: [{
platform: 'threads',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
threadItems: [
{
content: 'Here is a thread about API design 🧵',
mediaItems: [{ type: 'image', url: 'https://example.com/cover.jpg' }]
},
{ content: '1/ First, let us talk about REST principles...' },
{
content: '2/ Authentication is crucial. Here is what we recommend...',
mediaItems: [{ type: 'image', url: 'https://example.com/auth-diagram.jpg' }]
},
{ content: '3/ Finally, always version your API! /end' }
]
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'platforms': [{
'platform': 'threads',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'threadItems': [
{
'content': 'Here is a thread about API design 🧵',
'mediaItems': [{'type': 'image', 'url': 'https://example.com/cover.jpg'}]
},
{'content': '1/ First, let us talk about REST principles...'},
{
'content': '2/ Authentication is crucial. Here is what we recommend...',
'mediaItems': [{'type': 'image', 'url': 'https://example.com/auth-diagram.jpg'}]
},
{'content': '3/ Finally, always version your API! /end'}
]
}
}],
'publishNow': True
}
)
```
### Thread Sequence Notes
- First item is the root post
- Subsequent items become replies in order
- Each item can have its own media
- No limit on thread length
## Carousel Posts
Multiple images in a single swipeable post:
```json
{
"content": "Product launch day! Here are all the new features:",
"mediaItems": [
{ "type": "image", "url": "https://example.com/feature1.jpg" },
{ "type": "image", "url": "https://example.com/feature2.jpg" },
{ "type": "image", "url": "https://example.com/feature3.jpg" }
],
"platforms": [
{ "platform": "threads", "accountId": "acc_123" }
]
}
```
Up to **20 images** per carousel.
## GIF Support
Threads supports animated GIFs:
- Auto-play in feed
- Max 8 MB
- Counts toward image limit
- May be converted to video internally
## Link Previews
URLs in text generate preview cards:
```json
{
"content": "Just published a new blog post! https://myblog.com/new-post",
"platforms": [
{ "platform": "threads", "accountId": "acc_123" }
]
}
```
## Text Limits
| Property | Limit |
|----------|-------|
| Post text | 500 characters |
| With link | Link may use additional space |
## Common Issues
### "Too many images"
Max 20 images per post. Use a thread sequence for more content.
### Video too long
Max duration is 5 minutes. Trim or split longer videos.
### Image rejected
- Check file size (≤8 MB)
- Ensure valid format
- Verify aspect ratio is reasonable
### Thread sequence failed
- Ensure first item has content
- Check each item's media individually
- Verify account permissions
### "Media type mismatch"
Unlike TikTok, Threads allows mixing images and videos in thread sequences, but not in a single post with multiple media.
## Inbox
> **Requires [Inbox add-on](/pricing)** — $1/social set/month
Threads supports comment management through the unified Inbox API. Threads does not have direct messaging.
### Comments
| Feature | Supported |
|---------|-----------|
| List comments on posts | ✅ |
| Post new comment | ❌ |
| Reply to comments | ✅ |
| Delete comments | ✅ |
| Like/unlike comments | ❌ |
| Hide/unhide comments | ✅ |
### Limitations
- **No DMs** — Threads API does not support direct messages
- **No comment likes** — Threads API does not support liking comments
- **Reply-only** — Cannot post new top-level comments, only replies
See [Comments API Reference](/core/comments) for endpoint details.
## Related API Endpoints
- [Connect Threads Account](/core/connect) — Via Instagram authentication
- [Create Post](/core/posts) — Post creation and scheduling
- [Upload Media](/utilities/media) — Image and video uploads
- [Comments](/core/comments)
---
# TikTok API
Post to TikTok with Late API - Videos, photo carousels, and creator tools
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
## Quick Start
Post to TikTok in under 60 seconds:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Check out this amazing sunset! 🌅 #sunset #nature",
"mediaItems": [
{"type": "video", "url": "https://example.com/sunset-video.mp4"}
],
"platforms": [{
"platform": "tiktok",
"accountId": "YOUR_ACCOUNT_ID"
}],
"tiktokSettings": {
"privacy_level": "PUBLIC_TO_EVERYONE",
"allow_comment": true,
"allow_duet": true,
"allow_stitch": true,
"content_preview_confirmed": true,
"express_consent_given": true
},
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Check out this amazing sunset! 🌅 #sunset #nature',
mediaItems: [
{ type: 'video', url: 'https://example.com/sunset-video.mp4' }
],
platforms: [{
platform: 'tiktok',
accountId: 'YOUR_ACCOUNT_ID'
}],
tiktokSettings: {
privacy_level: 'PUBLIC_TO_EVERYONE',
allow_comment: true,
allow_duet: true,
allow_stitch: true,
content_preview_confirmed: true,
express_consent_given: true
},
publishNow: true
})
});
const { post } = await response.json();
console.log('Posted to TikTok!', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Check out this amazing sunset! 🌅 #sunset #nature',
'mediaItems': [
{'type': 'video', 'url': 'https://example.com/sunset-video.mp4'}
],
'platforms': [{
'platform': 'tiktok',
'accountId': 'YOUR_ACCOUNT_ID'
}],
'tiktokSettings': {
'privacy_level': 'PUBLIC_TO_EVERYONE',
'allow_comment': True,
'allow_duet': True,
'allow_stitch': True,
'content_preview_confirmed': True,
'express_consent_given': True
},
'publishNow': True
}
)
post = response.json()['post']
print(f"Posted to TikTok! {post['_id']}")
```
## Content Types
TikTok supports two content types:
| Type | Description | Max Items |
|------|-------------|-----------|
| **Video** | Single video post | 1 |
| **Photo Carousel** | Multiple images | 35 |
**Important:** You cannot mix photos and videos in the same post.
## Video Requirements
| Property | Requirement |
|----------|-------------|
| **Formats** | MP4, MOV, WebM |
| **Max File Size** | 4 GB |
| **Max Duration** | 10 minutes |
| **Min Duration** | 3 seconds |
| **Resolution** | 720 × 1280 px minimum |
| **Aspect Ratio** | 9:16 (recommended) |
| **Frame Rate** | 24-60 fps |
| **Codec** | H.264 |
### Recommended Video Specs
| Property | Recommended |
|----------|-------------|
| Resolution | 1080 × 1920 px |
| Aspect Ratio | 9:16 (vertical) |
| Frame Rate | 30 fps |
| Bitrate | 10-20 Mbps |
| Audio | AAC, 128 kbps |
## Video Cover (Thumbnail)
Customize which frame appears as the thumbnail:
```json
{
"tiktokSettings": {
"video_cover_timestamp_ms": 3000
}
}
```
- Value in **milliseconds**
- Default: 1000 (1 second)
- Must be within video duration
## Photo Carousel
Create photo carousels with up to **35 images**:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "My travel highlights ✈️",
"mediaItems": [
{"type": "image", "url": "https://example.com/photo1.jpg"},
{"type": "image", "url": "https://example.com/photo2.jpg"},
{"type": "image", "url": "https://example.com/photo3.jpg"}
],
"platforms": [{
"platform": "tiktok",
"accountId": "YOUR_ACCOUNT_ID"
}],
"tiktokSettings": {
"privacy_level": "PUBLIC_TO_EVERYONE",
"allow_comment": true,
"media_type": "photo",
"photo_cover_index": 0,
"content_preview_confirmed": true,
"express_consent_given": true
},
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'My travel highlights ✈️',
mediaItems: [
{ type: 'image', url: 'https://example.com/photo1.jpg' },
{ type: 'image', url: 'https://example.com/photo2.jpg' },
{ type: 'image', url: 'https://example.com/photo3.jpg' }
],
platforms: [{
platform: 'tiktok',
accountId: 'YOUR_ACCOUNT_ID'
}],
tiktokSettings: {
privacy_level: 'PUBLIC_TO_EVERYONE',
allow_comment: true,
media_type: 'photo',
photo_cover_index: 0,
content_preview_confirmed: true,
express_consent_given: true
},
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'My travel highlights ✈️',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/photo1.jpg'},
{'type': 'image', 'url': 'https://example.com/photo2.jpg'},
{'type': 'image', 'url': 'https://example.com/photo3.jpg'}
],
'platforms': [{
'platform': 'tiktok',
'accountId': 'YOUR_ACCOUNT_ID'
}],
'tiktokSettings': {
'privacy_level': 'PUBLIC_TO_EVERYONE',
'allow_comment': True,
'media_type': 'photo',
'photo_cover_index': 0,
'content_preview_confirmed': True,
'express_consent_given': True
},
'publishNow': True
}
)
```
### Photo Carousel Requirements
| Property | Requirement |
|----------|-------------|
| **Max Photos** | 35 |
| **Formats** | JPEG, PNG, WebP |
| **Max File Size** | 20 MB per image |
| **Aspect Ratio** | 9:16 recommended |
| **Resolution** | 1080 × 1920 px recommended |
## Title/Caption Limits
| Content Type | Title Limit | Description |
|--------------|-------------|-------------|
| **Video** | 2200 chars | Full content used as title |
| **Photo** | 90 chars | Auto-truncated (hashtags/URLs stripped) |
For photo carousels with longer captions, use the `description` field:
```json
{
"tiktokSettings": {
"description": "This is my detailed description up to 4000 characters..."
}
}
```
## Auto-Add Music
Let TikTok add recommended music to photo carousels:
```json
{
"tiktokSettings": {
"auto_add_music": true
}
}
```
**Note:** Only works for photo carousels, not videos.
## AI Disclosure
Disclose AI-generated content:
```json
{
"tiktokSettings": {
"video_made_with_ai": true
}
}
```
## Draft Mode
Send to Creator Inbox as draft instead of publishing:
```json
{
"tiktokSettings": {
"draft": true
}
}
```
## Required TikTok Settings
Due to TikTok's Direct Post API requirements, these fields are **required**:
| Field | Required For | Notes |
|-------|--------------|-------|
| `privacy_level` | All | Must match allowed values from creator info |
| `allow_comment` | All | Enable/disable comments |
| `allow_duet` | Videos only | Enable/disable duets |
| `allow_stitch` | Videos only | Enable/disable stitches |
| `content_preview_confirmed` | All | Must be `true` |
| `express_consent_given` | All | Must be `true` |
## Common Issues
### "Invalid privacy_level"
The `privacy_level` must be one of the values allowed for the creator's account. Fetch allowed values from the TikTok creator info endpoint.
### "Missing required fields"
Ensure `content_preview_confirmed` and `express_consent_given` are both `true`.
### "Cannot mix media types"
TikTok doesn't allow photos and videos in the same post. Use either all photos or one video.
### Video rejected
- Check duration (3 sec - 10 min)
- Verify format (MP4 recommended)
- Ensure aspect ratio is vertical (9:16)
### Photo carousel title truncated
Photo titles are limited to 90 characters. Use the `description` field for longer text.
## Inbox
> **Requires [Inbox add-on](/pricing)** — $1/social set/month
TikTok has limited inbox support — comments are write-only.
### Comments
| Feature | Supported |
|---------|-----------|
| List comments on posts | ❌ (API limitation) |
| Post new comment | ✅ |
| Reply to comments | ✅ |
| Delete comments | ✅ |
### Limitations
- **Cannot read comments** — TikTok's API only supports posting comments, not reading them
- **No DMs** — TikTok does not provide API access to direct messages
See [Comments API Reference](/core/comments) for endpoint details.
## Related API Endpoints
- [Connect TikTok Account](/core/connect) — OAuth flow
- [Create Post](/core/posts) — Post creation and scheduling
- [Upload Media](/utilities/media) — Image and video uploads
- [TikTok Video Download](/tools/downloads) — Download TikTok videos
- [Comments](/core/comments)
---
# Twitter/X API
Post to Twitter/X with Late API - tweets, threads, images, videos, and GIFs
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
## Quick Start
Post to Twitter/X in under 60 seconds:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Hello from Late API! 🚀",
"platforms": [
{"platform": "twitter", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Hello from Late API! 🚀',
platforms: [
{ platform: 'twitter', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
const { post } = await response.json();
console.log('Tweet posted!', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Hello from Late API! 🚀',
'platforms': [
{'platform': 'twitter', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
post = response.json()['post']
print(f"Tweet posted! {post['_id']}")
```
## Image Requirements
| Property | Requirement |
|----------|-------------|
| **Max Images** | 4 per post |
| **Formats** | JPEG, PNG, WebP, GIF |
| **Max File Size** | 5 MB (images), 15 MB (GIFs) |
| **Min Dimensions** | 4 × 4 px |
| **Max Dimensions** | 8192 × 8192 px |
| **Recommended** | 1200 × 675 px (16:9) |
### Aspect Ratios
| Type | Ratio | Dimensions |
|------|-------|------------|
| Landscape | 16:9 | 1200 × 675 px |
| Square | 1:1 | 1200 × 1200 px |
| Portrait | 4:5 | 1080 × 1350 px |
## Post with Image
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Check out this photo! 📸",
"mediaItems": [
{"type": "image", "url": "https://example.com/photo.jpg"}
],
"platforms": [
{"platform": "twitter", "accountId": "YOUR_ACCOUNT_ID"}
],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Check out this photo! 📸',
mediaItems: [
{ type: 'image', url: 'https://example.com/photo.jpg' }
],
platforms: [
{ platform: 'twitter', accountId: 'YOUR_ACCOUNT_ID' }
],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Check out this photo! 📸',
'mediaItems': [
{'type': 'image', 'url': 'https://example.com/photo.jpg'}
],
'platforms': [
{'platform': 'twitter', 'accountId': 'YOUR_ACCOUNT_ID'}
],
'publishNow': True
}
)
```
## GIF Support
Twitter/X has excellent GIF support:
- Max file size: **15 MB**
- Max dimensions: **1280 × 1080 px**
- Animated GIFs play automatically in timeline
- Only **1 GIF** per post (counts as all 4 image slots)
```json
{
"content": "Check out this animation!",
"mediaItems": [
{ "type": "gif", "url": "https://example.com/animation.gif" }
],
"platforms": [
{ "platform": "twitter", "accountId": "acc_123" }
]
}
```
## Video Requirements
| Property | Requirement |
|----------|-------------|
| **Max Videos** | 1 per post |
| **Formats** | MP4, MOV |
| **Max File Size** | 512 MB |
| **Max Duration** | 2 minutes 20 seconds (140 sec) |
| **Min Duration** | 0.5 seconds |
| **Max Dimensions** | 1920 × 1200 px |
| **Min Dimensions** | 32 × 32 px |
| **Frame Rate** | 40 fps max |
| **Bitrate** | 25 Mbps max |
### Recommended Video Specs
For best quality on Twitter/X:
| Property | Recommended |
|----------|-------------|
| Resolution | 1280 × 720 px (720p) |
| Aspect Ratio | 16:9 (landscape) or 1:1 (square) |
| Frame Rate | 30 fps |
| Codec | H.264 |
| Audio | AAC, 128 kbps |
## Threads (Multi-Tweet)
Create Twitter threads with multiple connected tweets:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"platforms": [{
"platform": "twitter",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"threadItems": [
{
"content": "1/ Starting a thread about API design 🧵",
"mediaItems": [{"type": "image", "url": "https://example.com/image1.jpg"}]
},
{
"content": "2/ First, always use proper HTTP methods..."
},
{
"content": "3/ Second, version your APIs from day one..."
},
{
"content": "4/ Finally, document everything! /end"
}
]
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
platforms: [{
platform: 'twitter',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
threadItems: [
{
content: '1/ Starting a thread about API design 🧵',
mediaItems: [{ type: 'image', url: 'https://example.com/image1.jpg' }]
},
{ content: '2/ First, always use proper HTTP methods...' },
{ content: '3/ Second, version your APIs from day one...' },
{ content: '4/ Finally, document everything! /end' }
]
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'platforms': [{
'platform': 'twitter',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'threadItems': [
{
'content': '1/ Starting a thread about API design 🧵',
'mediaItems': [{'type': 'image', 'url': 'https://example.com/image1.jpg'}]
},
{'content': '2/ First, always use proper HTTP methods...'},
{'content': '3/ Second, version your APIs from day one...'},
{'content': '4/ Finally, document everything! /end'}
]
}
}],
'publishNow': True
}
)
```
## Common Issues
### Image Too Large
Twitter rejects images over 5 MB. Compress before upload or Late will attempt automatic compression.
### GIF Won't Animate
- Check file size (must be ≤ 15 MB)
- Ensure it's a true animated GIF, not a static image with `.gif` extension
- Twitter may convert large GIFs to video
### Video Rejected
Common causes:
- Duration over 2:20
- File size over 512 MB
- Unsupported codec (use H.264)
- Frame rate over 40 fps
## Inbox
> **Requires [Inbox add-on](/pricing)** — $1/social set/month
Twitter/X supports DMs and comments through the unified Inbox API.
### Direct Messages
| Feature | Supported |
|---------|-----------|
| List conversations | ✅ |
| Fetch messages | ✅ |
| Send text messages | ✅ |
| Send attachments | ✅ (images, videos — max 25 MB) |
| Archive/unarchive | ❌ |
### Comments
| Feature | Supported |
|---------|-----------|
| List comments on posts | ✅ |
| Post new comment | ✅ |
| Reply to comments | ✅ |
| Delete comments | ✅ |
| Like/unlike comments | ✅ |
| Hide/unhide comments | ❌ |
### Limitations
- **DM permissions** — DMs require `dm.read` and `dm.write` scopes
- **Reply search** — Uses cached conversation threads (2-min TTL) to manage rate limits
- **Cached DMs** — Conversations are cached with a 15-min TTL
See [Messages](/core/messages) and [Comments](/core/comments) API Reference for endpoint details.
## Related API Endpoints
- [Connect Twitter Account](/core/connect) — OAuth flow
- [Create Post](/core/posts) — Post creation and scheduling
- [Upload Media](/utilities/media) — Image and video uploads
- [Analytics](/core/analytics) — Post performance metrics
- [Messages](/core/messages) and [Comments](/core/comments)
---
# YouTube API
Post to YouTube with Late API - Videos, Shorts, thumbnails, and visibility settings
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
## Quick Start
Upload a video to YouTube:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "My Latest Video\n\nIn this video, I share my thoughts on...\n\n#tutorial #howto",
"mediaItems": [
{"type": "video", "url": "https://example.com/video.mp4"}
],
"platforms": [{
"platform": "youtube",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"title": "My Latest Video",
"visibility": "public"
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'My Latest Video\n\nIn this video, I share my thoughts on...\n\n#tutorial #howto',
mediaItems: [
{ type: 'video', url: 'https://example.com/video.mp4' }
],
platforms: [{
platform: 'youtube',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
title: 'My Latest Video',
visibility: 'public'
}
}],
publishNow: true
})
});
const { post } = await response.json();
console.log('Uploaded to YouTube!', post._id);
```
```python
import requests
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'My Latest Video\n\nIn this video, I share my thoughts on...\n\n#tutorial #howto',
'mediaItems': [
{'type': 'video', 'url': 'https://example.com/video.mp4'}
],
'platforms': [{
'platform': 'youtube',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'title': 'My Latest Video',
'visibility': 'public'
}
}],
'publishNow': True
}
)
post = response.json()['post']
print(f"Uploaded to YouTube! {post['_id']}")
```
## Video Types
YouTube automatically detects content type based on duration:
| Duration | Type | Notes |
|----------|------|-------|
| ≤ 3 minutes | **YouTube Shorts** | Vertical format, no custom thumbnails via API |
| > 3 minutes | **Regular Video** | Supports custom thumbnails |
## Video Requirements
| Property | Shorts | Regular Video |
|----------|--------|---------------|
| **Max Duration** | 3 minutes | 12 hours |
| **Min Duration** | 1 second | 1 second |
| **Max File Size** | 256 GB | 256 GB |
| **Formats** | MP4, MOV, AVI, WMV, FLV, 3GP | MP4, MOV, AVI, WMV, FLV, 3GP |
| **Aspect Ratio** | 9:16 (vertical) | 16:9 (horizontal) |
| **Resolution** | 1080 × 1920 px | 1920 × 1080 px (1080p) |
### Recommended Specs
| Property | Shorts | Regular Video |
|----------|--------|---------------|
| Resolution | 1080 × 1920 px | 3840 × 2160 px (4K) |
| Frame Rate | 30 fps | 24-60 fps |
| Codec | H.264 | H.264 or H.265 |
| Audio | AAC, 128 kbps | AAC, 384 kbps |
| Bitrate | 10 Mbps | 35-68 Mbps (4K) |
## Title and Description
| Property | Limit | Notes |
|----------|-------|-------|
| Title | 100 characters | Defaults to first line of content |
| Description | 5000 characters | Full content used |
The `content` field becomes the video description. The title is either:
1. Specified in `platformSpecificData.title`
2. Auto-extracted from first line of content
3. "Untitled Video" as fallback
## Visibility Options
Control who can see your video:
| Visibility | Description |
|------------|-------------|
| `public` | Anyone can search and watch (default) |
| `unlisted` | Only people with link can watch |
| `private` | Only you and shared users |
```json
{
"platformSpecificData": {
"visibility": "unlisted"
}
}
```
## Custom Thumbnails
For regular videos (>3 min), add a custom thumbnail:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "My Video Description",
"mediaItems": [{
"type": "video",
"url": "https://example.com/video.mp4",
"thumbnail": {
"url": "https://example.com/thumbnail.jpg"
}
}],
"platforms": [{
"platform": "youtube",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"title": "My Video Title",
"visibility": "public"
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'My Video Description',
mediaItems: [{
type: 'video',
url: 'https://example.com/video.mp4',
thumbnail: {
url: 'https://example.com/thumbnail.jpg'
}
}],
platforms: [{
platform: 'youtube',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
title: 'My Video Title',
visibility: 'public'
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'My Video Description',
'mediaItems': [{
'type': 'video',
'url': 'https://example.com/video.mp4',
'thumbnail': {
'url': 'https://example.com/thumbnail.jpg'
}
}],
'platforms': [{
'platform': 'youtube',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'title': 'My Video Title',
'visibility': 'public'
}
}],
'publishNow': True
}
)
```
### Thumbnail Requirements
| Property | Requirement |
|----------|-------------|
| Format | JPEG, PNG, GIF |
| Max Size | 2 MB |
| Resolution | 1280 × 720 px (16:9) |
| Min Width | 640 px |
**Note:** Custom thumbnails are **not supported for Shorts** via API.
## Made for Kids (COPPA Compliance)
YouTube requires videos to declare whether they are made for kids (child-directed content) to comply with COPPA regulations:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Fun Educational Video for Children",
"mediaItems": [
{"type": "video", "url": "https://example.com/kids-video.mp4"}
],
"platforms": [{
"platform": "youtube",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"title": "Learn Colors with Animals",
"madeForKids": true
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Fun Educational Video for Children',
mediaItems: [
{ type: 'video', url: 'https://example.com/kids-video.mp4' }
],
platforms: [{
platform: 'youtube',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
title: 'Learn Colors with Animals',
madeForKids: true
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Fun Educational Video for Children',
'mediaItems': [
{'type': 'video', 'url': 'https://example.com/kids-video.mp4'}
],
'platforms': [{
'platform': 'youtube',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'title': 'Learn Colors with Animals',
'madeForKids': True
}
}],
'publishNow': True
}
)
```
| Value | Description |
|-------|-------------|
| `true` | Video is made for kids (child-directed content) |
| `false` | Video is NOT made for kids (default) |
> **Important:** Videos marked as made for kids have restricted features including disabled comments, no notification bell, and limited ad targeting. If not specified, defaults to `false`. YouTube may require this to be explicitly configured in YouTube Studio if not set via API.
## Video Categories
Specify a category for your video to help YouTube organize and recommend it:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Learn Python programming from scratch",
"mediaItems": [
{"type": "video", "url": "https://example.com/tutorial.mp4"}
],
"platforms": [{
"platform": "youtube",
"accountId": "YOUR_ACCOUNT_ID",
"platformSpecificData": {
"title": "Python Tutorial for Beginners",
"categoryId": "27"
}
}],
"publishNow": true
}'
```
```javascript
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
content: 'Learn Python programming from scratch',
mediaItems: [
{ type: 'video', url: 'https://example.com/tutorial.mp4' }
],
platforms: [{
platform: 'youtube',
accountId: 'YOUR_ACCOUNT_ID',
platformSpecificData: {
title: 'Python Tutorial for Beginners',
categoryId: '27'
}
}],
publishNow: true
})
});
```
```python
response = requests.post(
'https://getlate.dev/api/v1/posts',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
json={
'content': 'Learn Python programming from scratch',
'mediaItems': [
{'type': 'video', 'url': 'https://example.com/tutorial.mp4'}
],
'platforms': [{
'platform': 'youtube',
'accountId': 'YOUR_ACCOUNT_ID',
'platformSpecificData': {
'title': 'Python Tutorial for Beginners',
'categoryId': '27'
}
}],
'publishNow': True
}
)
```
### Available Categories
| Category ID | Name |
|-------------|------|
| `1` | Film & Animation |
| `2` | Autos & Vehicles |
| `10` | Music |
| `15` | Pets & Animals |
| `17` | Sports |
| `20` | Gaming |
| `22` | People & Blogs (default) |
| `23` | Comedy |
| `24` | Entertainment |
| `25` | News & Politics |
| `26` | Howto & Style |
| `27` | Education |
| `28` | Science & Technology |
> **Note:** If not specified, videos default to category `22` (People & Blogs).
## First Comment
Add an automatic pinned comment:
```json
{
"platformSpecificData": {
"firstComment": "Thanks for watching! Don't forget to subscribe. What topics should I cover next? 👇"
}
}
```
- Max 10,000 characters
- Posted immediately after upload
- Can include links
## Scheduled Videos
When scheduling a YouTube video:
1. Video uploads immediately with specified visibility
2. Stays in that state until scheduled time
3. At scheduled time, may change to "public" if originally set
```json
{
"scheduledFor": "2024-12-25T10:00:00Z",
"platforms": [
{
"platform": "youtube",
"platformSpecificData": {
"visibility": "private"
}
}
]
}
```
## Supported Formats
| Format | Extension | Notes |
|--------|-----------|-------|
| MPEG-4 | .mp4 | Recommended |
| QuickTime | .mov | Well supported |
| AVI | .avi | Supported |
| WMV | .wmv | Windows Media |
| FLV | .flv | Flash Video |
| 3GPP | .3gp | Mobile format |
| WebM | .webm | Supported |
| MPEG-PS | .mpg | Supported |
## Common Issues
### Video stuck processing
Large videos (>1 GB) may take 30+ minutes to process. Use scheduled posts for async handling.
### Wrong video type detected
- Shorts: ≤3 min + vertical aspect ratio
- Regular: >3 min OR horizontal aspect ratio
- Ensure aspect ratio matches intent
### Thumbnail rejected
- Must be exactly 16:9 aspect ratio
- Max 2 MB file size
- Min 640 px width
- Not available for Shorts
### Audio issues
- Use AAC codec
- Avoid copyright-protected music
- Ensure audio bitrate is at least 128 kbps
### Resolution too low
Minimum recommended:
- Shorts: 720 × 1280 px
- Regular: 1280 × 720 px (720p)
## Inbox
> **Requires [Inbox add-on](/pricing)** — $1/social set/month
YouTube supports comments only (no DMs available on the platform).
### Comments
| Feature | Supported |
|---------|-----------|
| List comments on videos | ✅ |
| Reply to comments | ✅ |
| Delete comments | ✅ |
| Like comments | ❌ (no API available) |
### Limitations
- **No DMs** — YouTube does not have a direct messaging system
- **No comment likes** — No public API endpoint available for liking comments
See [Comments API Reference](/core/comments) for endpoint details.
## Related API Endpoints
- [Connect YouTube Account](/core/connect) — OAuth flow
- [Create Post](/core/posts) — Post creation and scheduling
- [Upload Media](/utilities/media) — Video uploads
- [YouTube Video Download](/tools/downloads) — Download YouTube videos
- [YouTube Transcripts](/tools/transcripts) — Get video transcripts
- [Comments](/core/comments)
---
# Social Media MCP
Schedule posts directly from Claude Desktop using natural language
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
import { Callout } from 'fumadocs-ui/components/callout';
import { Step, Steps } from 'fumadocs-ui/components/steps';
Schedule social media posts directly from Claude Desktop using natural language. No coding required.
This uses the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) to connect Claude Desktop with Late API.
## What You Can Do
Ask Claude things like:
- *"Post 'Hello world!' to Twitter"*
- *"Schedule a LinkedIn post for tomorrow at 9am"*
- *"Show my connected accounts"*
- *"Cross-post this to Twitter and LinkedIn"*
- *"Post this image to Instagram"* (with browser upload flow)
## Setup
### Install uv
uv is a fast Python package manager that Claude Desktop uses to run the Late MCP server.
```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```
```powershell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```
### Get Your API Key
Go to [getlate.dev/dashboard/api-keys](https://getlate.dev/dashboard/api-keys) and create an API key.
### Configure Claude Desktop
Open Claude Desktop settings and go to **Developer** → **Edit Config**:
This will open the folder containing `claude_desktop_config.json`. Open this file with your favorite editor:
```
~/Library/Application Support/Claude/claude_desktop_config.json
```
```
%APPDATA%\Claude\claude_desktop_config.json
```
Add the Late MCP server:
```json
{
"mcpServers": {
"late": {
"command": "uvx",
"args": ["--from", "late-sdk[mcp]", "late-mcp"],
"env": {
"LATE_API_KEY": "your_api_key_here"
}
}
}
}
```
Replace `your_api_key_here` with your actual API key from Step 2.
### Restart Claude Desktop
Close and reopen Claude Desktop. The Late integration will be available immediately.
## Alternative: Using pip
If you prefer pip over uvx:
```bash
pip install late-sdk[mcp]
```
```json
{
"mcpServers": {
"late": {
"command": "python",
"args": ["-m", "late.mcp"],
"env": {
"LATE_API_KEY": "your_api_key_here"
}
}
}
}
```
## Available Commands
| Command | Description |
|---------|-------------|
| `accounts_list` | Show all connected social media accounts |
| `accounts_get` | Get account details for a specific platform |
| `profiles_list` | Show all profiles |
| `profiles_get` | Get details of a specific profile |
| `profiles_create` | Create a new profile |
| `profiles_update` | Update an existing profile |
| `profiles_delete` | Delete a profile |
| `posts_list` | List posts (optionally filter by status) |
| `posts_get` | Get details of a specific post |
| `posts_create` | Create a new post (draft, scheduled, or immediate) |
| `posts_publish_now` | Publish a post immediately |
| `posts_cross_post` | Post to multiple platforms at once |
| `posts_update` | Update an existing post |
| `posts_delete` | Delete a post |
| `posts_retry` | Retry a failed post |
| `posts_list_failed` | List all failed posts |
| `posts_retry_all_failed` | Retry all failed posts |
| `media_generate_upload_link` | Get a link to upload media files |
| `media_check_upload_status` | Check if media upload is complete |
## Tool Reference
Detailed parameters for each MCP tool.
### Accounts
#### `accounts_list`
List all connected social media accounts. Returns the platform, username, and account ID for each connected account. Use this to find account IDs needed for creating posts.
#### `accounts_get`
Get account details for a specific platform. Returns username and ID for the first account matching the platform.
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `platform` | `string` | Platform name: twitter, instagram, linkedin, tiktok, bluesky, facebook, youtube, pinterest, threads, googlebusiness, telegram, snapchat | Yes | - |
### Profiles
#### `profiles_list`
List all profiles. Profiles group multiple social accounts together for easier management.
#### `profiles_get`
Get details of a specific profile including name, description, and color.
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `profile_id` | `string` | The profile ID | Yes | - |
#### `profiles_create`
Create a new profile for grouping social accounts.
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `name` | `string` | Profile name | Yes | - |
| `description` | `string` | Optional description | No | `""` |
| `color` | `string` | Optional hex color (e.g., '#4CAF50') | No | `""` |
#### `profiles_update`
Update an existing profile. Only provided fields will be changed.
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `profile_id` | `string` | The profile ID to update | Yes | - |
| `name` | `string` | New name (leave empty to keep current) | No | `""` |
| `description` | `string` | New description (leave empty to keep current) | No | `""` |
| `color` | `string` | New hex color (leave empty to keep current) | No | `""` |
| `is_default` | `boolean` | Set as default profile | No | `false` |
#### `profiles_delete`
Delete a profile. The profile must have no connected accounts.
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `profile_id` | `string` | The profile ID to delete | Yes | - |
### Posts
#### `posts_create`
Create a social media post. Can be saved as DRAFT, SCHEDULED, or PUBLISHED immediately.
**Choose the correct mode based on user intent:**
- **DRAFT MODE** (`is_draft=true`): Use when user says "draft", "save for later", "don't publish". Post is saved but NOT published.
- **IMMEDIATE MODE** (`publish_now=true`): Use when user says "publish now", "post now", "immediately". Post goes live right away.
- **SCHEDULED MODE** (default): Use when user says "schedule", "in X minutes/hours". Post is scheduled for future publication.
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `content` | `string` | The post text/content | Yes | - |
| `platform` | `string` | Target platform: twitter, instagram, linkedin, tiktok, bluesky, facebook, youtube, pinterest, threads, googlebusiness, telegram, snapchat | Yes | - |
| `is_draft` | `boolean` | Set to true to save as DRAFT (not published, not scheduled) | No | `false` |
| `publish_now` | `boolean` | Set to true to publish IMMEDIATELY | No | `false` |
| `schedule_minutes` | `integer` | Minutes from now to schedule. Only used when is_draft=false AND publish_now=false | No | `60` |
| `media_urls` | `string` | Comma-separated URLs of media files to attach (images, videos) | No | `""` |
| `title` | `string` | Post title (required for YouTube, recommended for Pinterest) | No | `""` |
#### `posts_publish_now`
Publish a post immediately to a platform. The post goes live right away. This is a convenience wrapper around `posts_create` with `publish_now=true`.
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `content` | `string` | The post text/content | Yes | - |
| `platform` | `string` | Target platform: twitter, instagram, linkedin, tiktok, bluesky, etc. | Yes | - |
| `media_urls` | `string` | Comma-separated URLs of media files to attach | No | `""` |
#### `posts_cross_post`
Post the same content to multiple platforms at once.
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `content` | `string` | The post text/content | Yes | - |
| `platforms` | `string` | Comma-separated list of platforms (e.g., 'twitter,linkedin,bluesky') | Yes | - |
| `is_draft` | `boolean` | Set to true to save as DRAFT (not published) | No | `false` |
| `publish_now` | `boolean` | Set to true to publish IMMEDIATELY to all platforms | No | `false` |
| `media_urls` | `string` | Comma-separated URLs of media files to attach | No | `""` |
#### `posts_list`
List posts with optional filtering by status.
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `status` | `string` | Filter by status: draft, scheduled, published, failed. Leave empty for all posts | No | `""` |
| `limit` | `integer` | Maximum number of posts to return | No | `10` |
#### `posts_get`
Get full details of a specific post including content, status, and scheduling info.
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `post_id` | `string` | The post ID to retrieve | Yes | - |
#### `posts_update`
Update an existing post. Only draft, scheduled, and failed posts can be updated. Published posts cannot be modified.
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `post_id` | `string` | The post ID to update | Yes | - |
| `content` | `string` | New content (leave empty to keep current) | No | `""` |
| `scheduled_for` | `string` | New schedule time as ISO string (leave empty to keep current) | No | `""` |
| `title` | `string` | New title (leave empty to keep current) | No | `""` |
#### `posts_delete`
Delete a post by ID. Published posts cannot be deleted.
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `post_id` | `string` | The post ID to delete | Yes | - |
#### `posts_retry`
Retry publishing a failed post. Only works on posts with 'failed' status.
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `post_id` | `string` | The ID of the failed post to retry | Yes | - |
#### `posts_list_failed`
List all failed posts that can be retried.
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `limit` | `integer` | Maximum number of posts to return | No | `10` |
#### `posts_retry_all_failed`
Retry all failed posts at once.
### Media
#### `media_generate_upload_link`
Generate a unique upload URL for the user to upload files via browser.
Use this when the user wants to include images or videos in their post. The flow is:
1. Call this tool to get an upload URL
2. Ask the user to open the URL in their browser
3. User uploads files through the web interface
4. Call `media_check_upload_status` to get the uploaded file URLs
5. Use those URLs when creating the post with `posts_create`
#### `media_check_upload_status`
Check the status of an upload token and get uploaded file URLs.
Use this after the user has uploaded files through the browser upload page. Returns: pending (waiting for upload), completed (files ready), or expired (token expired).
| Parameter | Type | Description | Required | Default |
|-----------|------|-------------|----------|---------|
| `token` | `string` | The upload token from media_generate_upload_link | Yes | - |
## Uploading Images & Videos
Since Claude Desktop can't access files on your computer directly, we use a browser upload flow:
### Ask Claude to Create an Upload Link
Say something like: *"I want to post an image to Instagram"*
Claude will give you a unique upload URL.
### Upload Your File
Open the URL in your browser. You'll see a simple upload page where you can drag & drop your image or video.
### Tell Claude You're Done
Just say *"done"* or *"uploaded"*. Claude will check the status and create your post with the media attached.
**Supported file types:**
- Images: JPG, PNG, WebP, GIF
- Videos: MP4, MOV, WebM
- Documents: PDF
**Maximum file size:** 5GB
## Example Conversations
### Simple Post
> **You:** Post "Just launched our new feature! 🚀" to Twitter
>
> **Claude:** ✅ Published to Twitter (@yourhandle)
> Post ID: post_abc123
### Scheduled Post
> **You:** Schedule a LinkedIn post for tomorrow at 9am: "Excited to announce our Series A funding!"
>
> **Claude:** ✅ Scheduled for LinkedIn (@yourcompany)
> Post ID: post_xyz789
> Scheduled: 2024-12-12 09:00
### Cross-Posting
> **You:** Post "Big news coming soon..." to Twitter and LinkedIn
>
> **Claude:** ✅ Published to: twitter, linkedin
> Post ID: post_multi456
### Draft Post
> **You:** Create a draft post for Twitter with the text "Working on something exciting..."
>
> **Claude:** 📝 Draft saved for twitter (@yourhandle)
> Post ID: post_draft789
> Status: draft
### With Image
> **You:** I want to post a product photo to Instagram
>
> **Claude:** 📤 Upload link generated!
> Open this link in your browser to upload: http://...
>
> **You:** done
>
> **Claude:** ✅ Upload completed! 1 file uploaded.
> Now I'll create the post...
> ✅ Published to Instagram with 1 media file
## Troubleshooting
### "Command not found: uvx"
Make sure uv is installed and in your PATH:
```bash
# Check if installed
uvx --version
# If not, install it
curl -LsSf https://astral.sh/uv/install.sh | sh
```
You may need to restart your terminal or add uv to your PATH.
### "Invalid API key"
1. Check your API key at [getlate.dev/dashboard/api-keys](https://getlate.dev/dashboard/api-keys)
2. Make sure you copied it correctly (no extra spaces)
3. Verify the key is active
### "No accounts connected"
You need to connect social media accounts at [getlate.dev](https://getlate.dev) before you can post.
### Changes not taking effect
After editing `claude_desktop_config.json`, you must restart Claude Desktop completely.
## Links
- [Late Dashboard](https://getlate.dev)
- [Get API Key](https://getlate.dev/dashboard/api-keys)
- [SDKs](/resources/sdks)
- [MCP Protocol](https://modelcontextprotocol.io/)
---
# OpenAPI Specs
Download official OpenAPI specs for Twitter, Instagram, TikTok, LinkedIn, Facebook, YouTube, and more. Free OpenAPI 3.0 specifications for all major social media platform APIs.
import { Cards, Card } from 'fumadocs-ui/components/card';
Free, downloadable OpenAPI specifications for all major social media platforms. Use these specs to generate SDKs, build API clients, or explore API capabilities in tools like Swagger UI or Postman.
All specs are maintained in our [public GitHub repository](https://github.com/getlate-dev/openapi-specs).
## Platform API Specifications
## Direct Download Links
| Platform | Download | Size |
|----------|----------|------|
| Twitter / X | [twitter.yaml](https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/twitter.yaml) | 478 KB |
| Pinterest | [pinterest.yaml](https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/pinterest.yaml) | 1.5 MB |
| Telegram | [telegram.yaml](https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/telegram.yaml) | 111 KB |
| YouTube | [youtube.yaml](https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/youtube.yaml) | 96 KB |
| Reddit | [reddit.yaml](https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/reddit.yaml) | 71 KB |
| Google Business | [googlebusiness.yaml](https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/googlebusiness.yaml) | 59 KB |
| LinkedIn | [linkedin.yaml](https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/linkedin.yaml) | 54 KB |
| Snapchat | [snapchat.yaml](https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/snapchat.yaml) | 51 KB |
| Threads | [threads.yaml](https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/threads.yaml) | 50 KB |
| Bluesky | [bluesky.yaml](https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/bluesky.yaml) | 45 KB |
| TikTok | [tiktok.yaml](https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/tiktok.yaml) | 43 KB |
| Instagram | [instagram.yaml](https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/instagram.yaml) | 39 KB |
| Facebook | [facebook.yaml](https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/facebook.yaml) | 38 KB |
## What is OpenAPI?
OpenAPI Specification (formerly Swagger) is a standard format for describing REST APIs. With an OpenAPI spec, you can:
- **Generate SDKs** in any programming language
- **Import into Postman** for instant API testing
- **Use Swagger UI** to explore and test endpoints interactively
- **Generate documentation** automatically
- **Validate requests/responses** in your applications
## Using These Specs
### Import into Postman
1. Copy the raw URL for your platform (e.g., `https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/twitter.yaml`)
2. Open Postman and go to **File → Import**
3. Paste the URL or download and select the file
4. Postman will create a collection with all endpoints
### Generate an SDK
Use [OpenAPI Generator](https://openapi-generator.tech/) to create client libraries:
```bash
# Download the spec
curl -O https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/twitter.yaml
# Generate TypeScript SDK
openapi-generator-cli generate -i twitter.yaml -g typescript-fetch -o ./twitter-sdk
```
### View in Swagger UI
```bash
docker run -p 8080:8080 -e SWAGGER_JSON_URL=https://raw.githubusercontent.com/getlate-dev/openapi-specs/main/twitter.yaml swaggerapi/swagger-ui
```
## Contributing
Found an issue or want to improve a spec? Contributions are welcome on [GitHub](https://github.com/getlate-dev/openapi-specs).
## One API for All Platforms
Instead of integrating with each platform separately, [Late API](https://getlate.dev) provides a unified API that works across all 13+ social media platforms with a single integration.
- **One authentication flow** for all platforms
- **Consistent data formats** across platforms
- **Single webhook** for all platform events
- **Unified rate limiting** and error handling
[Get started with Late API →](/)
---
# SDKs
Official Late API client libraries for Node.js, Python, Go, Ruby, Java, PHP, .NET, and Rust. Post to 13+ social platforms.
import { Cards, Card } from 'fumadocs-ui/components/card';
## Official SDKs
}
title="Node.js"
description="github.com/getlate-dev/late-node"
href="https://github.com/getlate-dev/late-node"
/>
}
title="Python"
description="github.com/getlate-dev/late-python"
href="https://github.com/getlate-dev/late-python"
/>
}
title="Go"
description="github.com/getlate-dev/late-go"
href="https://github.com/getlate-dev/late-go"
/>
}
title="Ruby"
description="github.com/getlate-dev/late-ruby"
href="https://github.com/getlate-dev/late-ruby"
/>
}
title="Java"
description="github.com/getlate-dev/late-java"
href="https://github.com/getlate-dev/late-java"
/>
}
title="PHP"
description="github.com/getlate-dev/late-php"
href="https://github.com/getlate-dev/late-php"
/>
}
title=".NET"
description="github.com/getlate-dev/late-dotnet"
href="https://github.com/getlate-dev/late-dotnet"
/>
}
title="Rust"
description="github.com/getlate-dev/late-rust"
href="https://github.com/getlate-dev/late-rust"
/>
## OpenAPI
}
title="OpenAPI Spec"
description="getlate.dev/openapi.yaml"
href="https://getlate.dev/openapi.yaml"
/>
---
# Account Settings API Reference
Platform-specific account settings: Facebook persistent menu, Instagram ice breakers, and Telegram bot commands.
## GET /v1/accounts/{accountId}/messenger-menu
**Get Facebook persistent menu**
Get the persistent menu configuration for a Facebook Messenger account.
### Parameters
- **accountId** (required) in path: No description
### Responses
#### 200: Persistent menu configuration
**Response Body:**
- **data** `array[object]`:
Type: `object`
#### 400: Not a Facebook account
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## PUT /v1/accounts/{accountId}/messenger-menu
**Set Facebook persistent menu**
Set the persistent menu for a Facebook Messenger account. Max 3 top-level items, max 5 nested items.
### Parameters
- **accountId** (required) in path: No description
### Request Body
- **persistent_menu** (required) `array`: Persistent menu configuration array (Meta format)
### Responses
#### 200: Menu set successfully
#### 400: Invalid request
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## DELETE /v1/accounts/{accountId}/messenger-menu
**Delete Facebook persistent menu**
### Parameters
- **accountId** (required) in path: No description
### Responses
#### 200: Menu deleted
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## GET /v1/accounts/{accountId}/instagram-ice-breakers
**Get Instagram ice breakers**
Get the ice breaker configuration for an Instagram account.
### Parameters
- **accountId** (required) in path: No description
### Responses
#### 200: Ice breaker configuration
**Response Body:**
- **data** `array[object]`:
Type: `object`
#### 400: Not an Instagram account
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## PUT /v1/accounts/{accountId}/instagram-ice-breakers
**Set Instagram ice breakers**
Set ice breakers for an Instagram account. Max 4 ice breakers, question max 80 chars.
### Parameters
- **accountId** (required) in path: No description
### Request Body
- **ice_breakers** (required) `array`: No description
### Responses
#### 200: Ice breakers set successfully
#### 400: Invalid request
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## DELETE /v1/accounts/{accountId}/instagram-ice-breakers
**Delete Instagram ice breakers**
### Parameters
- **accountId** (required) in path: No description
### Responses
#### 200: Ice breakers deleted
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## GET /v1/accounts/{accountId}/telegram-commands
**Get Telegram bot commands**
Get the bot commands configuration for a Telegram account.
### Parameters
- **accountId** (required) in path: No description
### Responses
#### 200: Bot commands list
**Response Body:**
- **data** `array[object]`:
- **command** `string`: No description
- **description** `string`: No description
#### 400: Not a Telegram account
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## PUT /v1/accounts/{accountId}/telegram-commands
**Set Telegram bot commands**
Set bot commands for a Telegram account.
### Parameters
- **accountId** (required) in path: No description
### Request Body
- **commands** (required) `array`: No description
### Responses
#### 200: Commands set successfully
#### 400: Invalid request
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## DELETE /v1/accounts/{accountId}/telegram-commands
**Delete Telegram bot commands**
### Parameters
- **accountId** (required) in path: No description
### Responses
#### 200: Commands deleted
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
---
# Accounts API Reference
Connect and manage social media accounts across all supported platforms
## GET /v1/accounts
**List connected social accounts**
Returns list of connected social accounts.
By default, only returns accounts from profiles within the user's plan limit.
Follower count data (followersCount, followersLastUpdated) is only included if user has analytics add-on.
### Parameters
- **profileId** (optional) in query: Filter accounts by profile ID
- **includeOverLimit** (optional) in query: When true, includes accounts from profiles that exceed the user's plan limit.
Useful for disconnecting accounts from over-limit profiles so they can be deleted.
### Responses
#### 200: Accounts
**Response Body:**
- **accounts** `array[SocialAccount]`:
- **hasAnalyticsAccess** `boolean`: Whether user has analytics add-on access
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## GET /v1/accounts/follower-stats
**Get follower stats and growth metrics**
Returns follower count history and growth metrics for connected social accounts.
**Requires analytics add-on subscription.**
**Data Freshness:** Follower counts are automatically refreshed once per day.
### Parameters
- **accountIds** (optional) in query: Comma-separated list of account IDs (optional, defaults to all user's accounts)
- **profileId** (optional) in query: Filter by profile ID
- **fromDate** (optional) in query: Start date in YYYY-MM-DD format (defaults to 30 days ago)
- **toDate** (optional) in query: End date in YYYY-MM-DD format (defaults to today)
- **granularity** (optional) in query: Data aggregation level
### Responses
#### 200: Follower stats
**Response Body:**
- **accounts** `array[AccountWithFollowerStats]`:
- **stats** `object`: No description
- **dateRange** `object`:
- **from** `string` (date-time): No description
- **to** `string` (date-time): No description
- **granularity** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Analytics add-on required
**Response Body:**
- **error** `string`: No description (example: "Analytics add-on required")
- **message** `string`: No description (example: "Follower stats tracking requires the Analytics add-on. Please upgrade to access this feature.")
- **requiresAddon** `boolean`: No description (example: true)
---
## PUT /v1/accounts/{accountId}
**Update a social account**
### Parameters
- **accountId** (required) in path: No description
### Request Body
- **username** `string`: No description
- **displayName** `string`: No description
### Responses
#### 200: Updated
**Response Body:**
- **message** `string`: No description
- **username** `string`: No description
- **displayName** `string`: No description
#### 400: Invalid request
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
## DELETE /v1/accounts/{accountId}
**Disconnect a social account**
### Parameters
- **accountId** (required) in path: No description
### Responses
#### 200: Disconnected
**Response Body:**
- **message** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
## GET /v1/accounts/health
**Check health of all connected accounts**
Returns the health status of all connected social accounts, including token validity,
permissions status, and any issues that need attention. Useful for monitoring account
connections and identifying accounts that need reconnection.
### Parameters
- **profileId** (optional) in query: Filter by profile ID
- **platform** (optional) in query: Filter by platform
- **status** (optional) in query: Filter by health status
### Responses
#### 200: Account health summary
**Response Body:**
- **summary** `object`:
- **total** `integer`: Total number of accounts
- **healthy** `integer`: Number of healthy accounts
- **warning** `integer`: Number of accounts with warnings
- **error** `integer`: Number of accounts with errors
- **needsReconnect** `integer`: Number of accounts needing reconnection
- **accounts** `array[object]`:
- **accountId** `string`: No description
- **platform** `string`: No description
- **username** `string`: No description
- **displayName** `string`: No description
- **profileId** `string`: No description
- **status** `string`: No description - one of: healthy, warning, error
- **canPost** `boolean`: No description
- **canFetchAnalytics** `boolean`: No description
- **tokenValid** `boolean`: No description
- **tokenExpiresAt** `string` (date-time): No description
- **needsReconnect** `boolean`: No description
- **issues** `array[string]`:
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## GET /v1/accounts/{accountId}/health
**Check health of a specific account**
Returns detailed health information for a specific social account, including token status,
granted permissions, missing permissions, and actionable recommendations.
### Parameters
- **accountId** (required) in path: The account ID to check
### Responses
#### 200: Account health details
**Response Body:**
- **accountId** `string`: No description
- **platform** `string`: No description
- **username** `string`: No description
- **displayName** `string`: No description
- **status** `string`: Overall health status - one of: healthy, warning, error
- **tokenStatus** `object`:
- **valid** `boolean`: Whether the token is valid
- **expiresAt** `string` (date-time): No description
- **expiresIn** `string`: Human-readable time until expiry
- **needsRefresh** `boolean`: Whether token expires within 24 hours
- **permissions** `object`:
- **posting** `array[object]`:
- **scope** `string`: No description
- **granted** `boolean`: No description
- **required** `boolean`: No description
- **analytics** `array[object]`:
- **scope** `string`: No description
- **granted** `boolean`: No description
- **required** `boolean`: No description
- **optional** `array[object]`:
- **scope** `string`: No description
- **granted** `boolean`: No description
- **required** `boolean`: No description
- **canPost** `boolean`: No description
- **canFetchAnalytics** `boolean`: No description
- **missingRequired** `array[string]`:
- **issues** `array[string]`: List of issues found
- **recommendations** `array[string]`: Actionable recommendations to fix issues
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
# Related Schema Definitions
## SocialAccount
### Properties
- **_id** `string`: No description
- **platform** `string`: No description
- **profileId**: No description
- **username** `string`: No description
- **displayName** `string`: No description
- **profileUrl** `string`: Full profile URL for the connected account. Available for all platforms:
- Twitter/X: https://x.com/{username}
- Instagram: https://instagram.com/{username}
- TikTok: https://tiktok.com/@{username}
- YouTube: https://youtube.com/@{handle} or https://youtube.com/channel/{id}
- LinkedIn Personal: https://www.linkedin.com/in/{vanityName}/
- LinkedIn Organization: https://www.linkedin.com/company/{vanityName}/
- Threads: https://threads.net/@{username}
- Pinterest: https://pinterest.com/{username}
- Reddit: https://reddit.com/user/{username}
- Bluesky: https://bsky.app/profile/{handle}
- Facebook: https://facebook.com/{username} or https://facebook.com/{pageId}
- Google Business: Google Maps URL for the business location
- **isActive** `boolean`: No description
- **followersCount** `number`: Follower count (only included if user has analytics add-on)
- **followersLastUpdated** `string`: Last time follower count was updated (only included if user has analytics add-on)
## AccountWithFollowerStats
---
# Analytics API Reference
Retrieve post performance metrics, engagement data, and analytics via the Late API
## GET /v1/analytics
**Unified analytics for posts**
Returns analytics for posts. If postId is provided, returns analytics for a single post.
Otherwise returns a paginated list of posts with overview stats.
**Important: Understanding Post IDs**
This endpoint uses two types of posts:
- **Late Posts** - Posts scheduled/created via the Late API (e.g., via `POST /v1/posts`)
- **External Posts** - Posts synced from social platforms for analytics tracking
When you schedule a post via Late and it gets published, **both** records exist:
1. The original Late Post (returned when you created the post)
2. An External Post (created when we sync analytics from the platform)
**List endpoint behavior:**
- Returns External Post IDs (`_id` field)
- Use the `isExternal` field to identify post origin:
- `isExternal: true` - Synced from platform (may have been originally scheduled via Late)
- `isExternal: false` - Late-scheduled post (shown when querying by Late post ID)
**Single post behavior (`postId` parameter):**
- Accepts **both** Late Post IDs and External Post IDs
- If you pass a Late Post ID, the API automatically resolves it to the corresponding External Post analytics
- Both return the same analytics data for the same underlying social media post
**Correlating posts:** Use `latePostId` to link analytics entries back to the original post created via `POST /v1/posts`. This field contains the Late Post ID when the external post originated from Late. Alternatively, use `platformPostUrl` (e.g., `https://www.instagram.com/reel/ABC123/`) as a stable identifier.
**Note:** For follower count history and growth metrics, use the dedicated `/v1/accounts/follower-stats` endpoint.
**LinkedIn Analytics:**
- **Personal Accounts:** Per-post analytics available for posts published through Late. External posts cannot be synced due to LinkedIn API restrictions.
- **Organization Accounts:** Full analytics support including external post syncing.
**Telegram Analytics:**
- **Not available.** The Telegram Bot API does not provide message view counts, forwards, or engagement metrics. This is a Telegram platform limitation, not a Late limitation. View counts are only visible to channel admins in the Telegram app.
**Data Freshness:** Analytics data is cached and refreshed at most once per hour. When you call this endpoint, if the cache is older than 60 minutes, a background refresh is triggered and you'll see updated data on subsequent requests. There is no rate limit on API requests.
### Parameters
- **postId** (optional) in query: Returns analytics for a single post. Accepts both Late Post IDs (from `POST /v1/posts`)
and External Post IDs (from this endpoint's list response). The API automatically
resolves Late Post IDs to their corresponding External Post analytics.
- **platform** (optional) in query: Filter by platform (default "all")
- **profileId** (optional) in query: Filter by profile ID (default "all")
- **source** (optional) in query: Filter by post source:
- `late` - Only posts scheduled/published via Late API
- `external` - Only posts synced from the platform (not posted via Late)
- `all` - All posts (default)
- **fromDate** (optional) in query: Inclusive lower bound
- **toDate** (optional) in query: Inclusive upper bound
- **limit** (optional) in query: Page size (default 50)
- **page** (optional) in query: Page number (default 1)
- **sortBy** (optional) in query: Sort by date or engagement
- **order** (optional) in query: Sort order
### Responses
#### 200: Analytics result
**Response Body:**
*One of the following:*
- `AnalyticsSinglePostResponse`
- `AnalyticsListResponse`
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 402: Analytics add-on required
**Response Body:**
- **error** `string`: No description (example: "Analytics add-on required")
- **code** `string`: No description (example: "analytics_addon_required")
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
#### 500: Internal server error
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
## GET /v1/analytics/youtube/daily-views
**YouTube daily views breakdown**
Returns historical daily view counts for a specific YouTube video.
Uses YouTube Analytics API v2 to fetch daily breakdowns including views,
watch time, and subscriber changes.
**Required Scope:** This endpoint requires the `yt-analytics.readonly` OAuth scope.
Existing YouTube accounts may need to re-authorize to grant this permission.
If the scope is missing, the response will include a `reauthorizeUrl`.
**Data Latency:** YouTube Analytics data has a 2-3 day delay. The `endDate`
is automatically capped to 3 days ago.
**Date Range:** Maximum 90 days of historical data available. Defaults to last 30 days.
### Parameters
- **videoId** (required) in query: The YouTube video ID (e.g., "dQw4w9WgXcQ")
- **accountId** (required) in query: The Late account ID for the YouTube account
- **startDate** (optional) in query: Start date (YYYY-MM-DD). Defaults to 30 days ago.
- **endDate** (optional) in query: End date (YYYY-MM-DD). Defaults to 3 days ago (YouTube data latency).
### Responses
#### 200: Daily views breakdown
**Response Body:**
- **success** `boolean`: No description (example: true)
- **videoId** `string`: The YouTube video ID
- **dateRange** `object`:
- **startDate** `string` (date): No description
- **endDate** `string` (date): No description
- **totalViews** `integer`: Sum of views across all days in the range
- **dailyViews** `array[object]`:
- **date** `string` (date): No description
- **views** `integer`: No description
- **estimatedMinutesWatched** `number`: No description
- **averageViewDuration** `number`: Average view duration in seconds
- **subscribersGained** `integer`: No description
- **subscribersLost** `integer`: No description
- **likes** `integer`: No description
- **comments** `integer`: No description
- **shares** `integer`: No description
- **lastSyncedAt** `string` (date-time): When the data was last synced from YouTube
- **scopeStatus** `object`:
- **hasAnalyticsScope** `boolean`: No description
#### 400: Bad request (missing or invalid parameters)
**Response Body:**
- **error** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 402: Analytics add-on required
**Response Body:**
- **error** `string`: No description (example: "Analytics add-on required")
- **code** `string`: No description (example: "analytics_addon_required")
#### 403: Access denied to this account
**Response Body:**
- **error** `string`: No description (example: "Access denied to this account")
#### 412: Missing YouTube Analytics scope
**Response Body:**
- **success** `boolean`: No description (example: false)
- **error** `string`: No description (example: "To access daily video analytics, please reconnect your YouTube account to grant the required permissions.")
- **code** `string`: No description (example: "youtube_analytics_scope_missing")
- **scopeStatus** `object`:
- **hasAnalyticsScope** `boolean`: No description (example: false)
- **requiresReauthorization** `boolean`: No description (example: true)
- **reauthorizeUrl** `string` (uri): URL to redirect user for reauthorization
#### 500: Internal server error
**Response Body:**
- **success** `boolean`: No description (example: false)
- **error** `string`: No description
---
## GET /v1/accounts/follower-stats
**Get follower stats and growth metrics**
Returns follower count history and growth metrics for connected social accounts.
**Requires analytics add-on subscription.**
**Data Freshness:** Follower counts are automatically refreshed once per day.
### Parameters
- **accountIds** (optional) in query: Comma-separated list of account IDs (optional, defaults to all user's accounts)
- **profileId** (optional) in query: Filter by profile ID
- **fromDate** (optional) in query: Start date in YYYY-MM-DD format (defaults to 30 days ago)
- **toDate** (optional) in query: End date in YYYY-MM-DD format (defaults to today)
- **granularity** (optional) in query: Data aggregation level
### Responses
#### 200: Follower stats
**Response Body:**
- **accounts** `array[AccountWithFollowerStats]`:
- **stats** `object`: No description
- **dateRange** `object`:
- **from** `string` (date-time): No description
- **to** `string` (date-time): No description
- **granularity** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Analytics add-on required
**Response Body:**
- **error** `string`: No description (example: "Analytics add-on required")
- **message** `string`: No description (example: "Follower stats tracking requires the Analytics add-on. Please upgrade to access this feature.")
- **requiresAddon** `boolean`: No description (example: true)
---
## GET /v1/accounts/{accountId}/linkedin-aggregate-analytics
**Get aggregate analytics for a LinkedIn personal account**
Returns aggregate analytics across ALL posts for a LinkedIn personal account.
Uses LinkedIn's `memberCreatorPostAnalytics` API with `q=me` finder.
**Important:** This endpoint only works for LinkedIn **personal** accounts. Organization accounts should use the standard `/v1/analytics` endpoint for per-post analytics.
**Required Scope:** `r_member_postAnalytics`
If the connected account doesn't have this scope, you'll receive a 403 error with instructions to reconnect.
**Aggregation Options:**
- `TOTAL` (default): Returns lifetime totals for all metrics
- `DAILY`: Returns daily breakdown of metrics over time
**Available Metrics:**
- `IMPRESSION`: Number of times posts were displayed
- `MEMBERS_REACHED`: Unique members who saw posts (NOT available with DAILY aggregation)
- `REACTION`: Total reactions (likes, celebrates, etc.)
- `COMMENT`: Total comments
- `RESHARE`: Total reshares/reposts
**Date Range Filtering:**
Use `startDate` and `endDate` parameters to filter analytics to a specific time period.
If omitted, returns lifetime analytics.
**LinkedIn API Limitation:** The combination of `MEMBERS_REACHED` + `DAILY` aggregation is not supported by LinkedIn's API.
### Parameters
- **accountId** (required) in path: The ID of the LinkedIn personal account
- **aggregation** (optional) in query: Type of aggregation for the analytics data.
- `TOTAL` (default): Returns single totals for each metric
- `DAILY`: Returns daily breakdown of metrics
Note: `MEMBERS_REACHED` metric is not available with `DAILY` aggregation.
- **startDate** (optional) in query: Start date for analytics data in YYYY-MM-DD format.
If provided without endDate, endDate defaults to today.
If omitted entirely, returns lifetime analytics.
- **endDate** (optional) in query: End date for analytics data in YYYY-MM-DD format (exclusive).
If provided without startDate, startDate defaults to 30 days before endDate.
- **metrics** (optional) in query: Comma-separated list of metrics to fetch. If omitted, fetches all available metrics.
Valid values: IMPRESSION, MEMBERS_REACHED, REACTION, COMMENT, RESHARE
### Responses
#### 200: Aggregate analytics data
**Response Body:**
*One of the following:*
- `LinkedInAggregateAnalyticsTotalResponse`
- `LinkedInAggregateAnalyticsDailyResponse`
#### 400: Invalid request
**Response Body:**
- **error** `string`: No description
- **code** `string`: No description
- **validOptions** `array[string]`:
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 402: Analytics add-on required
**Response Body:**
- **error** `string`: No description
- **code** `string`: No description
#### 403: Missing required LinkedIn scope
**Response Body:**
- **error** `string`: No description
- **code** `string`: No description (example: "missing_scope")
- **requiredScope** `string`: No description (example: "r_member_postAnalytics")
- **action** `string`: No description (example: "reconnect")
#### 404: Account not found
---
## GET /v1/accounts/{accountId}/linkedin-post-analytics
**Get analytics for a specific LinkedIn post by URN**
Returns analytics for a specific LinkedIn post using its URN.
Works for both personal and organization accounts.
This is useful for fetching analytics of posts that weren't published through Late,
as long as you have the post URN.
**For Personal Accounts:**
- Uses `memberCreatorPostAnalytics` API + `memberCreatorVideoAnalytics` for video posts
- Requires `r_member_postAnalytics` scope
- Available metrics: impressions, reach, likes, comments, shares, video views (video posts only)
- **Clicks are NOT available** for personal accounts
**For Organization Accounts:**
- Uses `organizationalEntityShareStatistics` API + `videoAnalytics` for video posts
- Requires `r_organization_social` scope
- Available metrics: impressions, reach, clicks, likes, comments, shares, video views (video posts only), engagement rate
### Parameters
- **accountId** (required) in path: The ID of the LinkedIn account
- **urn** (required) in query: The LinkedIn post URN
### Responses
#### 200: Post analytics data
**Response Body:**
- **accountId** `string`: No description
- **platform** `string`: No description (example: "linkedin")
- **accountType** `string`: No description - one of: personal, organization
- **username** `string`: No description
- **postUrn** `string`: No description
- **analytics** `object`:
- **impressions** `integer`: Times the post was shown
- **reach** `integer`: Unique members who saw the post
- **likes** `integer`: Reactions on the post
- **comments** `integer`: Comments on the post
- **shares** `integer`: Reshares of the post
- **clicks** `integer`: Clicks on the post (organization accounts only)
- **views** `integer`: Video views (video posts only)
- **engagementRate** `number`: Engagement rate as percentage
- **lastUpdated** `string` (date-time): No description
#### 400: Invalid request
**Response Body:**
- **error** `string`: No description
- **code** `string`: No description - one of: missing_urn, invalid_urn, invalid_platform
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 402: Analytics add-on required
#### 403: Missing required LinkedIn scope
**Response Body:**
- **error** `string`: No description
- **code** `string`: No description (example: "missing_scope")
- **requiredScope** `string`: No description
- **action** `string`: No description (example: "reconnect")
#### 404: Account or post not found
**Response Body:**
- **error** `string`: No description
- **code** `string`: No description
---
# Related Schema Definitions
## AnalyticsSinglePostResponse
### Properties
- **postId** `string`: No description
- **status** `string`: No description
- **content** `string`: No description
- **scheduledFor** `string`: No description
- **publishedAt** `string`: No description
- **analytics**: No description
- **platformAnalytics** `array`: No description
- **platform** `string`: No description
- **platformPostUrl** `string`: No description
- **isExternal** `boolean`: No description
## AnalyticsListResponse
### Properties
- **overview**: No description
- **posts** `array`: No description
- **pagination**: No description
- **accounts** `array`: Connected social accounts (followerCount and followersLastUpdated only included if user has analytics add-on)
- **hasAnalyticsAccess** `boolean`: Whether user has analytics add-on access
## ErrorResponse
### Properties
- **error** `string`: No description
- **details** `object`: No description
## YouTubeDailyViewsResponse
### Properties
- **success** `boolean`: No description
- **videoId** `string`: The YouTube video ID
- **dateRange** `object`:
- **startDate** `string`:
- **endDate** `string`:
- **totalViews** `integer`: Sum of views across all days in the range
- **dailyViews** `array`: No description
- **lastSyncedAt** `string`: When the data was last synced from YouTube
- **scopeStatus** `object`:
- **hasAnalyticsScope** `boolean`:
## YouTubeScopeMissingResponse
### Properties
- **success** `boolean`: No description
- **error** `string`: No description
- **code** `string`: No description
- **scopeStatus** `object`:
- **hasAnalyticsScope** `boolean`:
- **requiresReauthorization** `boolean`:
- **reauthorizeUrl** `string`: URL to redirect user for reauthorization
## AccountWithFollowerStats
## LinkedInAggregateAnalyticsTotalResponse
Response for TOTAL aggregation (lifetime totals)
### Properties
- **accountId** `string`: No description
- **platform** `string`: No description
- **accountType** `string`: No description
- **username** `string`: No description
- **aggregation** `string`: No description - one of: TOTAL
- **dateRange** `object`:
- **startDate** `string`:
- **endDate** `string`:
- **analytics** `object`:
- **impressions** `integer`: Total impressions across all posts
- **reach** `integer`: Unique members reached across all posts
- **reactions** `integer`: Total reactions across all posts
- **comments** `integer`: Total comments across all posts
- **shares** `integer`: Total reshares across all posts
- **engagementRate** `number`: Overall engagement rate as percentage
- **note** `string`: No description
- **lastUpdated** `string`: No description
## LinkedInAggregateAnalyticsDailyResponse
Response for DAILY aggregation (time series breakdown)
### Properties
- **accountId** `string`: No description
- **platform** `string`: No description
- **accountType** `string`: No description
- **username** `string`: No description
- **aggregation** `string`: No description - one of: DAILY
- **dateRange** `object`:
- **startDate** `string`:
- **endDate** `string`:
- **analytics** `object`: Daily breakdown of each metric. Each metric contains an array of date/count pairs.
Note: 'reach' (MEMBERS_REACHED) is not available with DAILY aggregation per LinkedIn API limitations.
- **impressions** `array`:
- **reactions** `array`:
- **comments** `array`:
- **shares** `array`:
- **skippedMetrics** `array`: Metrics that were skipped due to API limitations
- **note** `string`: No description
- **lastUpdated** `string`: No description
---
# Comments API Reference
Unified inbox API for managing comments on posts across all connected accounts.
Supports commenting on third-party posts for platforms that allow it (YouTube, Twitter, Reddit, Bluesky, Threads).
All endpoints aggregate data from multiple social accounts in a single API call.
Requires Inbox addon.
## GET /v1/inbox/comments
**List posts with comments across all accounts**
Fetch posts with their comment counts from all connected accounts.
Aggregates data from multiple accounts in a single API call.
**Supported platforms:** Facebook, Instagram, Twitter/X, Bluesky, Threads, YouTube, LinkedIn, Reddit, TikTok (write-only)
### Parameters
- **profileId** (optional) in query: Filter by profile ID
- **platform** (optional) in query: Filter by platform
- **minComments** (optional) in query: Minimum comment count
- **since** (optional) in query: Posts created after this date
- **sortBy** (optional) in query: Sort field
- **sortOrder** (optional) in query: Sort order
- **limit** (optional) in query: No description
- **cursor** (optional) in query: No description
- **accountId** (optional) in query: Filter by specific social account ID
### Responses
#### 200: Aggregated posts with comments
**Response Body:**
- **data** `array[object]`:
- **id** `string`: No description
- **platform** `string`: No description
- **accountId** `string`: No description
- **accountUsername** `string`: No description
- **content** `string`: No description
- **picture** `string`: No description
- **permalink** `string`: No description
- **createdTime** `string` (date-time): No description
- **commentCount** `integer`: No description
- **likeCount** `integer`: No description
- **cid** `string`: Bluesky content identifier
- **subreddit** `string`: Reddit subreddit name
- **pagination** `object`:
- **hasMore** `boolean`: No description
- **nextCursor** `string`: No description
- **meta** `object`:
- **accountsQueried** `integer`: No description
- **accountsFailed** `integer`: No description
- **failedAccounts** `array[object]`:
- **accountId** `string`: No description
- **accountUsername** `string`: No description
- **platform** `string`: No description
- **error** `string`: No description
- **code** `string`: Error code if available
- **retryAfter** `integer`: Seconds to wait before retry (rate limits)
- **lastUpdated** `string` (date-time): No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
## GET /v1/inbox/comments/{postId}
**Get comments for a post**
Fetch comments for a specific post. Requires accountId query parameter.
### Parameters
- **postId** (required) in path: The post identifier. Accepts a Late post ID (MongoDB ObjectId) which is automatically resolved to the platform-specific post ID, or a platform-specific post ID directly (e.g. tweet ID, Facebook Graph ID, YouTube video ID).
- **accountId** (required) in query: No description
- **subreddit** (optional) in query: (Reddit only) Subreddit name
- **limit** (optional) in query: Maximum number of comments to return
- **cursor** (optional) in query: Pagination cursor
- **commentId** (optional) in query: (Reddit only) Get replies to a specific comment
### Responses
#### 200: Comments for the post
**Response Body:**
- **status** `string`: No description
- **comments** `array[object]`:
- **id** `string`: No description
- **message** `string`: No description
- **createdTime** `string` (date-time): No description
- **from** `object`:
- **id** `string`: No description
- **name** `string`: No description
- **username** `string`: No description
- **picture** `string`: No description
- **isOwner** `boolean`: No description
- **likeCount** `integer`: No description
- **replyCount** `integer`: No description
- **platform** `string`: The platform this comment is from
- **url** `string`: Direct link to the comment on the platform (if available)
- **replies** `array[object]`:
Type: `object`
- **canReply** `boolean`: No description
- **canDelete** `boolean`: No description
- **canHide** `boolean`: Whether this comment can be hidden (Facebook
- **canLike** `boolean`: Whether this comment can be liked (Facebook
- **isHidden** `boolean`: Whether the comment is currently hidden
- **isLiked** `boolean`: Whether the current user has liked this comment
- **likeUri** `string`: Bluesky like URI for unliking
- **cid** `string`: Bluesky content identifier
- **parentId** `string`: Parent comment ID for nested replies
- **rootUri** `string`: Bluesky root post URI
- **rootCid** `string`: Bluesky root post CID
- **pagination** `object`:
- **hasMore** `boolean`: No description
- **cursor** `string`: No description
- **meta** `object`:
- **platform** `string`: No description
- **postId** `string`: No description
- **accountId** `string`: No description
- **subreddit** `string`: (Reddit only) Subreddit name
- **lastUpdated** `string` (date-time): No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
## POST /v1/inbox/comments/{postId}
**Reply to a post or comment**
Post a reply to a post or specific comment. Requires accountId in request body.
### Parameters
- **postId** (required) in path: The post identifier. Accepts a Late post ID or a platform-specific post ID.
### Request Body
- **accountId** (required) `string`: No description
- **message** (required) `string`: No description
- **commentId** `string`: Reply to specific comment (optional)
- **subreddit** `string`: (Reddit only) Subreddit name for replies
- **parentCid** `string`: (Bluesky only) Parent content identifier
- **rootUri** `string`: (Bluesky only) Root post URI
- **rootCid** `string`: (Bluesky only) Root post CID
### Responses
#### 200: Reply posted
**Response Body:**
- **success** `boolean`: No description
- **data** `object`:
- **commentId** `string`: No description
- **isReply** `boolean`: No description
- **cid** `string`: Bluesky CID
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
## DELETE /v1/inbox/comments/{postId}
**Delete a comment**
Delete a comment on a post. Supported by Facebook, Instagram, Bluesky, Reddit, YouTube, LinkedIn, and TikTok.
Requires accountId and commentId query parameters.
### Parameters
- **postId** (required) in path: The post identifier. Accepts a Late post ID or a platform-specific post ID.
- **accountId** (required) in query: No description
- **commentId** (required) in query: No description
### Responses
#### 200: Comment deleted
**Response Body:**
- **success** `boolean`: No description
- **data** `object`:
- **message** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
## POST /v1/inbox/comments/{postId}/{commentId}/hide
**Hide a comment**
Hide a comment on a post. Supported by Facebook, Instagram, and Threads.
Hidden comments are only visible to the commenter and page admin.
### Parameters
- **postId** (required) in path: No description
- **commentId** (required) in path: No description
### Request Body
- **accountId** (required) `string`: The social account ID
### Responses
#### 200: Comment hidden
**Response Body:**
- **status** `string`: No description
- **commentId** `string`: No description
- **hidden** `boolean`: No description
- **platform** `string`: No description
#### 400: Platform does not support hiding comments
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
## DELETE /v1/inbox/comments/{postId}/{commentId}/hide
**Unhide a comment**
Unhide a previously hidden comment. Supported by Facebook, Instagram, and Threads.
### Parameters
- **postId** (required) in path: No description
- **commentId** (required) in path: No description
- **accountId** (required) in query: No description
### Responses
#### 200: Comment unhidden
**Response Body:**
- **status** `string`: No description
- **commentId** `string`: No description
- **hidden** `boolean`: No description
- **platform** `string`: No description
#### 400: Platform does not support unhiding comments
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
## POST /v1/inbox/comments/{postId}/{commentId}/like
**Like a comment**
Like or upvote a comment on a post.
**Supported platforms:** Facebook, Twitter/X, Bluesky, Reddit
For Bluesky, the `cid` (content identifier) is required in the request body.
### Parameters
- **postId** (required) in path: No description
- **commentId** (required) in path: No description
### Request Body
- **accountId** (required) `string`: The social account ID
- **cid** `string`: (Bluesky only) Content identifier for the comment
### Responses
#### 200: Comment liked
**Response Body:**
- **status** `string`: No description
- **commentId** `string`: No description
- **liked** `boolean`: No description
- **likeUri** `string`: (Bluesky only) URI to use for unliking
- **platform** `string`: No description
#### 400: Platform does not support liking comments
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
## DELETE /v1/inbox/comments/{postId}/{commentId}/like
**Unlike a comment**
Remove a like from a comment.
**Supported platforms:** Facebook, Twitter/X, Bluesky, Reddit
For Bluesky, the `likeUri` query parameter is required.
### Parameters
- **postId** (required) in path: No description
- **commentId** (required) in path: No description
- **accountId** (required) in query: No description
- **likeUri** (optional) in query: (Bluesky only) The like URI returned when liking
### Responses
#### 200: Comment unliked
**Response Body:**
- **status** `string`: No description
- **commentId** `string`: No description
- **liked** `boolean`: No description
- **platform** `string`: No description
#### 400: Platform does not support unliking comments
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
## POST /v1/inbox/comments/{postId}/{commentId}/private-reply
**Send private reply to comment author**
Send a private direct message to the author of a comment on your post.
This is useful for handling customer inquiries or sensitive matters privately.
**Supported platforms:** Instagram only
**Limitations:**
- Instagram only allows ONE private reply per comment
- Must be sent within 7 days of the comment being posted
- Only works for comments on posts owned by the connected account
- Message goes to the user's Inbox (if they follow you) or Message Requests (if they don't)
- Requires `instagram_business_manage_messages` permission (already included in Late's OAuth)
**Note:** This does not create a conversation thread until the user replies back.
### Parameters
- **postId** (required) in path: The Instagram media/post ID
- **commentId** (required) in path: The comment ID to send a private reply to
### Request Body
- **accountId** (required) `string`: The Instagram social account ID
- **message** (required) `string`: The message text to send as a private DM
### Responses
#### 200: Private reply sent successfully
**Response Body:**
- **status** `string`: No description (example: "success")
- **messageId** `string`: The ID of the sent message
- **commentId** `string`: The comment ID that was replied to
- **platform** `string`: No description (example: "instagram")
#### 400: Bad request
**Response Body:**
- **error** `string`: No description
- **code** `string`: No description - one of: PLATFORM_LIMITATION
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
#### 404: Account not found
---
---
# Connect API Reference
OAuth flows and connection management for linking social media platforms to Late
## GET /v1/connect/{platform}
**Start OAuth connection for a platform**
Initiate an OAuth connection flow for any supported social media platform.
**Standard Flow (Hosted UI):**
For Facebook connections, Late hosts the page selection UI:
1. Call this endpoint with your API key and `redirect_url` (optional)
2. Redirect your user to the returned `authUrl`
3. After OAuth, the user is redirected to Late’s hosted page selector at
`/connect/facebook/select-page?profileId=X&tempToken=Y&userProfile=Z&redirect_url=YOUR_URL&connect_token=CT`
4. After they pick a page, Late saves the connection and finally redirects to your `redirect_url` (if provided)
**Headless/Whitelabel Mode (Facebook, LinkedIn, Pinterest & Google Business Profile):**
Build your own fully branded selection UI while Late handles OAuth:
**Facebook:**
1. Call this endpoint with your API key and add `&headless=true`, e.g.
`GET /v1/connect/facebook?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true`
2. Redirect your user to the returned `authUrl`
3. After OAuth, the user is redirected directly to **your** `redirect_url` with:
- `profileId` – your Late profile ID
- `tempToken` – temporary Facebook access token
- `userProfile` – URL‑encoded JSON user profile
- `connect_token` – short‑lived connect token (for API auth)
- `platform=facebook`
- `step=select_page`
4. Use `tempToken`, `userProfile`, and the `X-Connect-Token` header with:
- `GET /v1/connect/facebook/select-page` to fetch pages
- `POST /v1/connect/facebook/select-page` to save the selected page
5. In this mode, users never see Late's hosted page selector – only your UI.
**LinkedIn:**
1. Call this endpoint with `&headless=true`, e.g.
`GET /v1/connect/linkedin?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true`
2. Redirect your user to the returned `authUrl`
3. After OAuth, the user is redirected directly to **your** `redirect_url` with:
- `profileId` – your Late profile ID
- `pendingDataToken` – token to fetch OAuth data via API (see step 4)
- `connect_token` – short-lived connect token (for API auth)
- `platform=linkedin`
- `step=select_organization`
4. Call `GET /v1/connect/pending-data?token=PENDING_DATA_TOKEN` to fetch the OAuth data:
- `tempToken` – temporary LinkedIn access token
- `userProfile` – JSON object with `id`, `username`, `displayName`, `profilePicture`
- `organizations` – JSON array with `id`, `urn`, `name`, `vanityName` for each org
- `refreshToken` / `expiresIn` – token metadata
This endpoint is one-time use and data expires after 10 minutes.
5. **Optional:** To fetch full organization details (logos, website, industry, description), call `GET /v1/connect/linkedin/organizations?tempToken=X&orgIds=id1,id2,...`
6. Call `POST /v1/connect/linkedin/select-organization` with the `X-Connect-Token` header to save the selection.
7. In this mode, users never see Late's hosted organization selector – only your UI.
8. Note: If the user has no organization admin access, `step=select_organization` will NOT be present,
and the account will be connected directly as a personal account.
**Pinterest:**
1. Call this endpoint with `&headless=true`, e.g.
`GET /v1/connect/pinterest?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true`
2. Redirect your user to the returned `authUrl`
3. After OAuth, the user is redirected directly to **your** `redirect_url` with:
- `profileId` – your Late profile ID
- `tempToken` – temporary Pinterest access token
- `userProfile` – URL‑encoded JSON user profile
- `connect_token` – short‑lived connect token (for API auth)
- `platform=pinterest`
- `step=select_board`
4. Use `tempToken`, `userProfile`, and the `X-Connect-Token` header with:
- `GET /v1/connect/pinterest/select-board` to fetch boards
- `POST /v1/connect/pinterest/select-board` to save the selected board
5. In this mode, users never see Late's hosted board selector – only your UI.
**Google Business Profile:**
1. Call this endpoint with `&headless=true`, e.g.
`GET /v1/connect/googlebusiness?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true`
2. Redirect your user to the returned `authUrl`
3. After OAuth, the user is redirected directly to **your** `redirect_url` with:
- `profileId` – your Late profile ID
- `tempToken` – temporary Google access token
- `userProfile` – URL‑encoded JSON user profile (includes refresh token info)
- `connect_token` – short‑lived connect token (for API auth)
- `platform=googlebusiness`
- `step=select_location`
4. Use `tempToken`, `userProfile`, and the `X-Connect-Token` header with:
- `GET /v1/connect/googlebusiness/locations` to fetch business locations
- `POST /v1/connect/googlebusiness/select-location` to save the selected location
5. In this mode, users never see Late's hosted location selector – only your UI.
### Parameters
- **platform** (required) in path: Social media platform to connect
- **profileId** (required) in query: Your Late profile ID (get from /v1/profiles)
- **redirect_url** (optional) in query: Optional: Your custom redirect URL after connection completes.
**Standard Mode:** Omit `headless=true` to use our hosted page selection UI.
After the user selects a Facebook Page, Late redirects here with:
`?connected=facebook&profileId=X&username=Y`
**Headless Mode (Facebook, LinkedIn, Pinterest, Google Business Profile & Snapchat):**
Pass `headless=true` as a query parameter on this endpoint (not inside `redirect_url`), e.g.:
`GET /v1/connect/facebook?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true`
`GET /v1/connect/linkedin?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true`
`GET /v1/connect/pinterest?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true`
`GET /v1/connect/googlebusiness?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true`
`GET /v1/connect/snapchat?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true`
After OAuth, the user is redirected directly to your `redirect_url` with OAuth data:
- **Facebook:** `?profileId=X&tempToken=Y&userProfile=Z&connect_token=CT&platform=facebook&step=select_page`
- **LinkedIn:** `?profileId=X&pendingDataToken=TOKEN&connect_token=CT&platform=linkedin&step=select_organization`
Use `GET /v1/connect/pending-data?token=TOKEN` to fetch tempToken, userProfile, organizations, refreshToken.
- **Pinterest:** `?profileId=X&tempToken=Y&userProfile=Z&connect_token=CT&platform=pinterest&step=select_board`
- **Google Business:** `?profileId=X&tempToken=Y&userProfile=Z&connect_token=CT&platform=googlebusiness&step=select_location`
- **Snapchat:** `?profileId=X&tempToken=Y&userProfile=Z&publicProfiles=PROFILES&connect_token=CT&platform=snapchat&step=select_public_profile`
(publicProfiles contains `id`, `display_name`, `username`, `profile_image_url`, `subscriber_count`)
Then use the respective endpoints to build your custom UI:
- Facebook: `/v1/connect/facebook/select-page` (GET to fetch, POST to save)
- LinkedIn: `/v1/connect/linkedin/organizations` (GET to fetch logos), `/v1/connect/linkedin/select-organization` (POST to save)
- Pinterest: `/v1/connect/pinterest/select-board` (GET to fetch, POST to save)
- Google Business: `/v1/connect/googlebusiness/locations` (GET) and `/v1/connect/googlebusiness/select-location` (POST)
- Snapchat: `/v1/connect/snapchat/select-profile` (POST to save selected public profile)
Example: `https://yourdomain.com/integrations/callback`
### Responses
#### 200: OAuth authorization URL to redirect user to
**Response Body:**
- **authUrl** `string` (uri): URL to redirect your user to for OAuth authorization
- **state** `string`: State parameter for security (handled automatically)
#### 400: Missing/invalid parameters (e.g., invalid profileId format)
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: No access to profile, or BYOK required for AppSumo Twitter
#### 404: Profile not found
---
## POST /v1/connect/{platform}
**Complete OAuth token exchange manually (for server-side flows)**
### Parameters
- **platform** (required) in path: No description
### Request Body
- **code** (required) `string`: No description
- **state** (required) `string`: No description
- **profileId** (required) `string`: No description
### Responses
#### 200: Account connected
#### 400: Invalid params
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: BYOK required for AppSumo Twitter
#### 500: Failed to connect account
---
## GET /v1/connect/facebook/select-page
**List Facebook Pages after OAuth (Headless Mode)**
**Headless Mode for Custom UI**
After initiating Facebook OAuth via `/v1/connect/facebook`, you'll be redirected to
`/connect/facebook/select-page` with query params including `tempToken` and `userProfile`.
For a **headless/whitelabeled flow**, extract these params from the URL and call this
endpoint to retrieve the list of Facebook Pages the user can manage. Then build your
own UI to let users select a page.
**Note:** Use the `X-Connect-Token` header if you initiated the connection via API key
(rather than a browser session).
### Parameters
- **profileId** (required) in query: Profile ID from your connection flow
- **tempToken** (required) in query: Temporary Facebook access token from the OAuth callback redirect
### Responses
#### 200: List of Facebook Pages available for connection
**Response Body:**
- **pages** `array[object]`:
- **id** `string`: Facebook Page ID
- **name** `string`: Page name
- **username** `string`: Page username/handle (may be null)
- **access_token** `string`: Page-specific access token
- **category** `string`: Page category
- **tasks** `array[string]`: User permissions for this page
#### 400: Missing required parameters (profileId or tempToken)
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 500: Failed to fetch pages (e.g., invalid token, insufficient permissions)
**Response Body:**
- **error** `string`: No description
---
## POST /v1/connect/facebook/select-page
**Select a Facebook Page to complete the connection (Headless Mode)**
**Complete the Headless Flow**
After displaying your custom UI with the list of pages from the GET endpoint, call this
endpoint to finalize the connection with the user's selected page.
The `userProfile` should be the decoded JSON object from the `userProfile` query param
in the OAuth callback redirect URL.
**Note:** Use the `X-Connect-Token` header if you initiated the connection via API key.
### Request Body
- **profileId** (required) `string`: Profile ID from your connection flow
- **pageId** (required) `string`: The Facebook Page ID selected by the user
- **tempToken** (required) `string`: Temporary Facebook access token from OAuth
- **userProfile** `object`: Decoded user profile object from the OAuth callback
- **redirect_url** `string`: Optional custom redirect URL to return to after selection
### Responses
#### 200: Facebook Page connected successfully
**Response Body:**
- **message** `string`: No description
- **redirect_url** `string`: Redirect URL if custom redirect_url was provided
- **account** `object`:
- **accountId** `string`: ID of the created SocialAccount
- **platform** `string`: No description - one of: facebook
- **username** `string`: No description
- **displayName** `string`: No description
- **profilePicture** `string`: No description
- **isActive** `boolean`: No description
- **selectedPageName** `string`: No description
#### 400: Missing required fields (profileId, pageId, or tempToken)
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: User does not have access to the specified profile
#### 404: Selected page not found in available pages
#### 500: Failed to save Facebook connection
---
## GET /v1/connect/googlebusiness/locations
**List Google Business Locations after OAuth (Headless Mode)**
**Headless Mode for Custom UI**
After initiating Google Business OAuth via `/v1/connect/googlebusiness?headless=true`, you'll be redirected
to your `redirect_url` with query params including `tempToken` and `userProfile`.
For a **headless/whitelabeled flow**, extract these params from the URL and call this
endpoint to retrieve the list of Google Business locations the user can manage. Then build your
own UI to let users select a location.
**Note:** Use the `X-Connect-Token` header if you initiated the connection via API key
(rather than a browser session).
### Parameters
- **profileId** (required) in query: Profile ID from your connection flow
- **tempToken** (required) in query: Temporary Google access token from the OAuth callback redirect
### Responses
#### 200: List of Google Business locations available for connection
**Response Body:**
- **locations** `array[object]`:
- **id** `string`: Location ID
- **name** `string`: Business name
- **accountId** `string`: Google Business Account ID
- **accountName** `string`: Account name
- **address** `string`: Business address
- **category** `string`: Business category
#### 400: Missing required parameters (profileId or tempToken)
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 500: Failed to fetch locations (e.g., invalid token, insufficient permissions)
**Response Body:**
- **error** `string`: No description
---
## POST /v1/connect/googlebusiness/select-location
**Select a Google Business location to complete the connection (Headless Mode)**
**Complete the Headless Flow**
After displaying your custom UI with the list of locations from the GET `/v1/connect/googlebusiness/locations`
endpoint, call this endpoint to finalize the connection with the user's selected location.
The `userProfile` should be the decoded JSON object from the `userProfile` query param
in the OAuth callback redirect URL. It contains important token information (including refresh token).
**Note:** Use the `X-Connect-Token` header if you initiated the connection via API key.
### Request Body
- **profileId** (required) `string`: Profile ID from your connection flow
- **locationId** (required) `string`: The Google Business location ID selected by the user
- **tempToken** (required) `string`: Temporary Google access token from OAuth
- **userProfile** `object`: Decoded user profile object from the OAuth callback. **Important:** This contains
the refresh token needed for token refresh. Always include this field.
- **redirect_url** `string`: Optional custom redirect URL to return to after selection
### Responses
#### 200: Google Business location connected successfully
**Response Body:**
- **message** `string`: No description
- **redirect_url** `string`: Redirect URL if custom redirect_url was provided
- **account** `object`:
- **accountId** `string`: ID of the created SocialAccount
- **platform** `string`: No description - one of: googlebusiness
- **username** `string`: No description
- **displayName** `string`: No description
- **isActive** `boolean`: No description
- **selectedLocationName** `string`: No description
- **selectedLocationId** `string`: No description
#### 400: Missing required fields (profileId, locationId, or tempToken)
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: User does not have access to the specified profile
#### 404: Selected location not found in available locations
#### 500: Failed to save Google Business connection
---
## GET /v1/connect/pending-data
**Fetch pending OAuth selection data (Headless Mode)**
**Fetch Pending OAuth Data for Headless Mode**
In headless mode, platforms like LinkedIn store OAuth selection data (organizations, pages, etc.)
in the database instead of passing it via URL parameters. This prevents URI_TOO_LONG errors
when users have many organizations/pages to select from.
After OAuth redirect, use the `pendingDataToken` from the URL to fetch the stored data.
**Important:**
- This endpoint is one-time use: data is deleted after being fetched
- Data expires automatically after 10 minutes if not fetched
- No authentication required, just the token from the redirect URL
### Parameters
- **token** (required) in query: The pending data token from the OAuth redirect URL (`pendingDataToken` parameter)
### Responses
#### 200: OAuth data fetched successfully
**Response Body:**
- **platform** `string`: The platform (e.g., "linkedin")
- **profileId** `string`: The Late profile ID
- **tempToken** `string`: Temporary access token for the platform
- **refreshToken** `string`: Refresh token (if available)
- **expiresIn** `number`: Token expiry in seconds
- **userProfile** `object`: User profile data (id, username, displayName, profilePicture)
- **selectionType** `string`: Type of selection data - one of: organizations, pages, boards, locations, profiles
- **organizations** `array[object]`: LinkedIn organizations (when selectionType is "organizations")
- **id** `string`: No description
- **urn** `string`: No description
- **name** `string`: No description
- **vanityName** `string`: No description
#### 400: Missing token parameter
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 404: Token not found or expired
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
## GET /v1/connect/linkedin/organizations
**Fetch full LinkedIn organization details (Headless Mode)**
**Fetch Full Organization Details for Custom UI**
After LinkedIn OAuth in headless mode, the redirect URL contains organization data with only
`id`, `urn`, and `name` fields (additional details are excluded to prevent URL length issues with many organizations).
Use this endpoint to fetch full organization details including logos, vanity names, websites, and more
if you want to display them in your custom selection UI.
**Note:** This endpoint requires no authentication - just the `tempToken` from the OAuth redirect.
Details are fetched directly from LinkedIn's API in parallel for fast response times.
### Parameters
- **tempToken** (required) in query: The temporary LinkedIn access token from the OAuth redirect
- **orgIds** (required) in query: Comma-separated list of organization IDs to fetch details for (max 100)
### Responses
#### 200: Organization details fetched successfully
**Response Body:**
- **organizations** `array[object]`:
- **id** `string`: Organization ID
- **logoUrl** `string` (uri): Logo URL (may be absent if no logo)
- **vanityName** `string`: Organization's vanity name/slug
- **website** `string` (uri): Organization's website URL
- **industry** `string`: Organization's primary industry
- **description** `string`: Organization's description
#### 400: Missing required parameters or too many organization IDs
**Response Body:**
- **error** `string`: No description
#### 500: Failed to fetch organization details
---
## POST /v1/connect/linkedin/select-organization
**Select LinkedIn organization or personal account after OAuth**
**Complete the LinkedIn Connection Flow**
After OAuth, the user is redirected with `organizations` in the URL params (if they have org admin access).
The organizations array contains `id`, `urn`, and `name` fields. Use this data to build your UI,
then call this endpoint to save the selection.
Set `accountType` to `personal` to connect as the user's personal LinkedIn profile, or
`organization` to connect as a company page (requires `selectedOrganization` object).
**Personal Profile:** To connect a personal LinkedIn account, set `accountType` to `"personal"`
and **omit** the `selectedOrganization` field entirely. This is the simplest flow.
**Headless Mode:** Use the `X-Connect-Token` header if you initiated the connection via API key.
### Request Body
- **profileId** (required) `string`: No description
- **tempToken** (required) `string`: No description
- **userProfile** (required) `object`: No description
- **accountType** (required) `string`: No description - one of: personal, organization
- **selectedOrganization** `object`: No description
- **redirect_url** `string`: No description
### Responses
#### 200: LinkedIn account connected
**Response Body:**
- **message** `string`: No description
- **redirect_url** `string`: The redirect URL with connection params appended (only if redirect_url was provided in request)
- **account** `object`:
- **accountId** `string`: ID of the created SocialAccount
- **platform** `string`: No description - one of: linkedin
- **username** `string`: No description
- **displayName** `string`: No description
- **profilePicture** `string`: No description
- **isActive** `boolean`: No description
- **accountType** `string`: No description - one of: personal, organization
- **bulkRefresh** `object`:
- **updatedCount** `integer`: No description
- **errors** `integer`: No description
#### 400: Missing required fields
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 500: Failed to connect LinkedIn account
---
## GET /v1/connect/pinterest/select-board
**List Pinterest Boards after OAuth (Headless Mode)**
**Retrieve Pinterest Boards for Selection UI**
After initiating Pinterest OAuth via `/v1/connect/pinterest` with `headless=true`, you'll be redirected to
your `redirect_url` with query params including `tempToken` and `userProfile`.
If you want to build your own fully-branded board selector (instead of Late's hosted UI), call this
endpoint to retrieve the list of Pinterest Boards the user can post to. Then build your
UI and call `POST /v1/connect/pinterest/select-board` to save the selection.
**Authentication:** Use `X-Connect-Token` header with the `connect_token` from the redirect URL.
### Parameters
- **X-Connect-Token** (required) in header: Short-lived connect token from the OAuth redirect
- **profileId** (required) in query: Your Late profile ID
- **tempToken** (required) in query: Temporary Pinterest access token from the OAuth callback redirect
### Responses
#### 200: List of Pinterest Boards available for connection
**Response Body:**
- **boards** `array[object]`:
- **id** `string`: Pinterest Board ID
- **name** `string`: Board name
- **description** `string`: Board description
- **privacy** `string`: Board privacy setting
#### 400: Missing required parameters
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: No access to profile
#### 500: Failed to fetch boards
---
## POST /v1/connect/pinterest/select-board
**Select a Pinterest Board to complete the connection (Headless Mode)**
**Complete the Pinterest Connection Flow**
After OAuth, use this endpoint to save the selected board and complete the Pinterest account connection.
**Headless Mode:** Use the `X-Connect-Token` header if you initiated the connection via API key.
### Request Body
- **profileId** (required) `string`: Your Late profile ID
- **boardId** (required) `string`: The Pinterest Board ID selected by the user
- **boardName** `string`: The board name (for display purposes)
- **tempToken** (required) `string`: Temporary Pinterest access token from OAuth
- **userProfile** `object`: User profile data from OAuth redirect
- **refreshToken** `string`: Pinterest refresh token (if available)
- **expiresIn** `integer`: Token expiration time in seconds
- **redirect_url** `string`: Custom redirect URL after connection completes
### Responses
#### 200: Pinterest Board connected successfully
**Response Body:**
- **message** `string`: No description
- **redirect_url** `string`: Redirect URL with connection params (if provided)
- **account** `object`:
- **accountId** `string`: ID of the created SocialAccount
- **platform** `string`: No description - one of: pinterest
- **username** `string`: No description
- **displayName** `string`: No description
- **profilePicture** `string`: No description
- **isActive** `boolean`: No description
- **defaultBoardName** `string`: No description
#### 400: Missing required fields
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: No access to profile or profile limit exceeded
#### 500: Failed to save Pinterest connection
---
## GET /v1/connect/snapchat/select-profile
**List Snapchat Public Profiles after OAuth (Headless Mode)**
**Headless Mode for Custom UI**
After initiating Snapchat OAuth via `/v1/connect/snapchat?headless=true`, you'll be redirected to
your `redirect_url` with query params including `tempToken`, `userProfile`, and `publicProfiles`.
If you want to build your own fully-branded profile selector (instead of Late's hosted UI), call this
endpoint to retrieve the list of Snapchat Public Profiles the user can post to. Then build your
UI and call `POST /v1/connect/snapchat/select-profile` to save the selection.
**Authentication:** Use `X-Connect-Token` header with the `connect_token` from the redirect URL.
### Parameters
- **X-Connect-Token** (required) in header: Short-lived connect token from the OAuth redirect
- **profileId** (required) in query: Your Late profile ID
- **tempToken** (required) in query: Temporary Snapchat access token from the OAuth callback redirect
### Responses
#### 200: List of Snapchat Public Profiles available for connection
**Response Body:**
- **publicProfiles** `array[object]`:
- **id** `string`: Snapchat Public Profile ID
- **display_name** `string`: Public profile display name
- **username** `string`: Public profile username/handle
- **profile_image_url** `string`: Profile image URL
- **subscriber_count** `integer`: Number of subscribers
#### 400: Missing required parameters (profileId or tempToken)
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: No access to profile
#### 500: Failed to fetch public profiles
---
## POST /v1/connect/snapchat/select-profile
**Select a Snapchat Public Profile to complete the connection (Headless Mode)**
**Complete the Snapchat Connection Flow**
After OAuth, use this endpoint to save the selected Public Profile and complete the Snapchat account connection.
Snapchat requires a Public Profile to publish Stories, Saved Stories, and Spotlight content.
**Headless Mode:** Use the `X-Connect-Token` header if you initiated the connection via API key.
After initiating Snapchat OAuth via `/v1/connect/snapchat?headless=true`, you'll be redirected to
your `redirect_url` with query params including:
- `tempToken` - Temporary access token
- `userProfile` - URL-encoded JSON with user info
- `publicProfiles` - URL-encoded JSON array of available public profiles
- `connect_token` - Short-lived token for API authentication
- `platform=snapchat`
- `step=select_public_profile`
Parse `publicProfiles` to build your custom selector UI, then call this endpoint with the selected profile.
### Parameters
- **X-Connect-Token** (optional) in header: Short-lived connect token from the OAuth redirect (for API users)
### Request Body
- **profileId** (required) `string`: Your Late profile ID
- **selectedPublicProfile** (required) `object`: The selected Snapchat Public Profile
- **tempToken** (required) `string`: Temporary Snapchat access token from OAuth
- **userProfile** (required) `object`: User profile data from OAuth redirect
- **refreshToken** `string`: Snapchat refresh token (if available)
- **expiresIn** `integer`: Token expiration time in seconds
- **redirect_url** `string`: Custom redirect URL after connection completes
### Responses
#### 200: Snapchat Public Profile connected successfully
**Response Body:**
- **message** `string`: No description
- **redirect_url** `string`: Redirect URL with connection params (if provided in request)
- **account** `object`:
- **accountId** `string`: ID of the created SocialAccount
- **platform** `string`: No description - one of: snapchat
- **username** `string`: No description
- **displayName** `string`: No description
- **profilePicture** `string`: No description
- **isActive** `boolean`: No description
- **publicProfileName** `string`: No description
#### 400: Missing required fields
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: No access to profile or profile limit exceeded
#### 500: Failed to connect Snapchat account
---
## POST /v1/connect/bluesky/credentials
**Connect Bluesky using app password**
Connect a Bluesky account using identifier (handle or email) and an app password.
To get your userId for the state parameter, call `GET /v1/users` - the response includes a `currentUserId` field.
### Request Body
- **identifier** (required) `string`: Your Bluesky handle (e.g. user.bsky.social) or email address
- **appPassword** (required) `string`: App password generated from Bluesky Settings > App Passwords
- **state** (required) `string`: Required state parameter formatted as `{userId}-{profileId}`.
- `userId`: Your Late user ID (get from `GET /v1/users` → `currentUserId`)
- `profileId`: The profile ID to connect the account to (get from `GET /v1/profiles`)
- **redirectUri** `string`: Optional URL to redirect to after successful connection
### Responses
#### 200: Bluesky connected successfully
**Response Body:**
- **message** `string`: No description
- **account**: `SocialAccount` - See schema definition
#### 400: Invalid request - missing fields or invalid state format
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 500: Internal error
---
## GET /v1/connect/telegram
**Generate Telegram access code**
Generate a unique access code for connecting a Telegram channel or group.
**Connection Flow:**
1. Call this endpoint to get an access code (valid for 15 minutes)
2. Add the bot (@LateScheduleBot or your configured bot) as an administrator in your Telegram channel/group
3. Open a private chat with the bot
4. Send: `{CODE} @yourchannel` (e.g., `LATE-ABC123 @mychannel`)
5. Poll `PATCH /v1/connect/telegram?code={CODE}` to check connection status
**Alternative for private channels:** If your channel has no public username, forward any message from the channel to the bot along with the access code.
### Parameters
- **profileId** (required) in query: The profile ID to connect the Telegram account to
### Responses
#### 200: Access code generated
**Response Body:**
- **code** `string`: The access code to send to the Telegram bot (example: "LATE-ABC123")
- **expiresAt** `string` (date-time): When the code expires
- **expiresIn** `integer`: Seconds until expiration (example: 900)
- **botUsername** `string`: The Telegram bot username to message (example: "LateScheduleBot")
- **instructions** `array[string]`: Step-by-step connection instructions
#### 400: Profile ID required or invalid format
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: No access to this profile
#### 404: Profile not found
#### 500: Internal error
---
## POST /v1/connect/telegram
**Direct Telegram connection (power users)**
Connect a Telegram channel/group directly using the chat ID.
This is an alternative to the access code flow for power users who know their Telegram chat ID.
The bot must already be added as an administrator in the channel/group.
### Request Body
- **chatId** (required) `string`: The Telegram chat ID. Can be:
- Numeric ID (e.g., "-1001234567890")
- Username with @ prefix (e.g., "@mychannel")
- **profileId** (required) `string`: The profile ID to connect the account to
### Responses
#### 200: Telegram channel connected successfully
**Response Body:**
- **message** `string`: No description
- **account** `object`:
- **_id** `string`: No description
- **platform** `string`: No description - one of: telegram
- **username** `string`: No description
- **displayName** `string`: No description
- **isActive** `boolean`: No description
- **chatType** `string`: No description - one of: channel, group, supergroup, private
#### 400: Chat ID required
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: No access to this profile
#### 404: Profile not found
#### 500: Internal error
---
## PATCH /v1/connect/telegram
**Check Telegram connection status**
Poll this endpoint to check if a Telegram access code has been used to connect a channel/group.
**Recommended polling interval:** 3 seconds
**Status values:**
- `pending`: Code is valid, waiting for user to complete connection
- `connected`: Connection successful - channel/group is now linked
- `expired`: Code has expired, generate a new one
### Parameters
- **code** (required) in query: The access code to check status for
### Responses
#### 200: Connection status
**Response Body:**
*One of the following:*
- **status** `string`: No description - one of: pending
- **expiresAt** `string` (date-time): No description
- **expiresIn** `integer`: Seconds until expiration
- **status** `string`: No description - one of: connected
- **chatId** `string`: No description
- **chatTitle** `string`: No description
- **chatType** `string`: No description - one of: channel, group, supergroup
- **account** `object`:
- **_id** `string`: No description
- **platform** `string`: No description
- **username** `string`: No description
- **displayName** `string`: No description
- **status** `string`: No description - one of: expired
- **message** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Code not found
#### 500: Internal error
---
## GET /v1/accounts/{accountId}/facebook-page
**List available Facebook pages for a connected account**
Returns all Facebook pages the connected account has access to, including the currently selected page.
### Parameters
- **accountId** (required) in path: No description
### Responses
#### 200: Pages list
**Response Body:**
- **pages** `array[object]`:
- **id** `string`: No description
- **name** `string`: No description
- **username** `string`: No description
- **category** `string`: No description
- **fan_count** `integer`: No description
- **selectedPageId** `string`: No description
- **cached** `boolean`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Account not found
---
## PUT /v1/accounts/{accountId}/facebook-page
**Update selected Facebook page for a connected account**
### Parameters
- **accountId** (required) in path: No description
### Request Body
- **selectedPageId** (required) `string`: No description
### Responses
#### 200: Page updated
**Response Body:**
- **message** `string`: No description
- **selectedPage** `object`:
- **id** `string`: No description
- **name** `string`: No description
#### 400: Page not in available pages
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Account not found
---
## GET /v1/accounts/{accountId}/linkedin-organizations
**Get available LinkedIn organizations for a connected account**
### Parameters
- **accountId** (required) in path: No description
### Responses
#### 200: Organizations list
**Response Body:**
- **organizations** `array[object]`:
- **id** `string`: No description
- **name** `string`: No description
- **vanityName** `string`: No description
- **localizedName** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Account not found
---
## PUT /v1/accounts/{accountId}/linkedin-organization
**Switch LinkedIn account type (personal/organization)**
### Parameters
- **accountId** (required) in path: No description
### Request Body
- **accountType** (required) `string`: No description - one of: personal, organization
- **selectedOrganization** `object`: No description
### Responses
#### 200: Account updated
**Response Body:**
- **message** `string`: No description
- **account**: `SocialAccount` - See schema definition
#### 400: Invalid request
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Account not found
---
## GET /v1/accounts/{accountId}/pinterest-boards
**List Pinterest boards for a connected account**
### Parameters
- **accountId** (required) in path: No description
### Responses
#### 200: Boards list
**Response Body:**
- **boards** `array[object]`:
- **id** `string`: No description
- **name** `string`: No description
- **description** `string`: No description
- **privacy** `string`: No description
#### 400: Not a Pinterest account
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Account not found
---
## PUT /v1/accounts/{accountId}/pinterest-boards
**Set default Pinterest board on the connection**
### Parameters
- **accountId** (required) in path: No description
### Request Body
- **defaultBoardId** (required) `string`: No description
- **defaultBoardName** `string`: No description
### Responses
#### 200: Default board set
**Response Body:**
- **message** `string`: No description
- **account**: `SocialAccount` - See schema definition
#### 400: Invalid request
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Account not found
---
## GET /v1/accounts/{accountId}/gmb-locations
**List available Google Business Profile locations for a connected account**
Returns all Google Business Profile locations the connected account has access to, including the currently selected location.
### Parameters
- **accountId** (required) in path: No description
### Responses
#### 200: Locations list
**Response Body:**
- **locations** `array[object]`:
- **id** `string`: No description
- **name** `string`: No description
- **accountId** `string`: No description
- **accountName** `string`: No description
- **address** `string`: No description
- **category** `string`: No description
- **websiteUrl** `string`: No description
- **selectedLocationId** `string`: No description
- **cached** `boolean`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Account not found
---
## PUT /v1/accounts/{accountId}/gmb-locations
**Update selected Google Business Profile location for a connected account**
### Parameters
- **accountId** (required) in path: No description
### Request Body
- **selectedLocationId** (required) `string`: No description
### Responses
#### 200: Location updated
**Response Body:**
- **message** `string`: No description
- **selectedLocation** `object`:
- **id** `string`: No description
- **name** `string`: No description
#### 400: Location not in available locations
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Account not found
---
## GET /v1/accounts/{accountId}/reddit-subreddits
**List Reddit subreddits for a connected account**
### Parameters
- **accountId** (required) in path: No description
### Responses
#### 200: Subreddits list
**Response Body:**
- **subreddits** `array[object]`:
- **id** `string`: Reddit subreddit ID
- **name** `string`: Subreddit name without r/ prefix
- **title** `string`: Subreddit title
- **url** `string`: Subreddit URL path
- **over18** `boolean`: Whether the subreddit is NSFW
- **defaultSubreddit** `string`: Currently set default subreddit for posting
#### 400: Not a Reddit account
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Account not found
---
## PUT /v1/accounts/{accountId}/reddit-subreddits
**Set default subreddit on the connection**
### Parameters
- **accountId** (required) in path: No description
### Request Body
- **defaultSubreddit** (required) `string`: No description
### Responses
#### 200: Default subreddit set
**Response Body:**
- **success** `boolean`: No description
#### 400: Invalid request
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Account not found
---
## GET /v1/accounts/{accountId}/reddit-flairs
**List available post flairs for a Reddit subreddit**
### Parameters
- **accountId** (required) in path: No description
- **subreddit** (required) in query: Subreddit name (without "r/" prefix) to fetch flairs for
### Responses
#### 200: Flairs list
**Response Body:**
- **flairs** `array[object]`:
- **id** `string`: Flair ID to pass as flairId in platformSpecificData
- **text** `string`: Flair display text
- **textColor** `string`: Text color: 'dark' or 'light'
- **backgroundColor** `string`: Background hex color (e.g. '#ff4500')
#### 400: Not a Reddit account or missing subreddit parameter
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Account not found
---
# Related Schema Definitions
## ErrorResponse
### Properties
- **error** `string`: No description
- **details** `object`: No description
## SocialAccount
### Properties
- **_id** `string`: No description
- **platform** `string`: No description
- **profileId**: No description
- **username** `string`: No description
- **displayName** `string`: No description
- **profileUrl** `string`: Full profile URL for the connected account. Available for all platforms:
- Twitter/X: https://x.com/{username}
- Instagram: https://instagram.com/{username}
- TikTok: https://tiktok.com/@{username}
- YouTube: https://youtube.com/@{handle} or https://youtube.com/channel/{id}
- LinkedIn Personal: https://www.linkedin.com/in/{vanityName}/
- LinkedIn Organization: https://www.linkedin.com/company/{vanityName}/
- Threads: https://threads.net/@{username}
- Pinterest: https://pinterest.com/{username}
- Reddit: https://reddit.com/user/{username}
- Bluesky: https://bsky.app/profile/{handle}
- Facebook: https://facebook.com/{username} or https://facebook.com/{pageId}
- Google Business: Google Maps URL for the business location
- **isActive** `boolean`: No description
- **followersCount** `number`: Follower count (only included if user has analytics add-on)
- **followersLastUpdated** `string`: Last time follower count was updated (only included if user has analytics add-on)
---
# Logs API Reference
Publishing logs for transparency and debugging. Shows detailed records of all post publishing attempts.
**Log Data Includes:**
- Platform API endpoint called
- HTTP status code
- Request body (content preview, media URLs)
- Response body (platform post ID/URL or error details)
- Duration and retry attempts
**Retention:** Logs are automatically deleted after 7 days via TTL index.
## GET /v1/logs
**Get publishing logs (deprecated)**
**Deprecated:** Use `/v1/posts/logs` instead. This endpoint is maintained for backwards compatibility.
Retrieve publishing logs for all posts. Logs show detailed information about each
publishing attempt including API requests, responses, and timing data.
**Filtering:**
- Filter by status (success, failed, pending, skipped)
- Filter by platform (instagram, twitter, linkedin, etc.)
- Filter by action (publish, retry, rate_limit_pause, etc.)
**Retention:** Logs are automatically deleted after 7 days.
### Parameters
- **status** (optional) in query: Filter by log status
- **platform** (optional) in query: Filter by platform
- **action** (optional) in query: Filter by action type
- **days** (optional) in query: Number of days to look back (max 7)
- **limit** (optional) in query: Maximum number of logs to return (max 100)
- **skip** (optional) in query: Number of logs to skip (for pagination)
### Responses
#### 200: Publishing logs retrieved successfully
**Response Body:**
- **logs** `array[PostLog]`:
- **pagination** `object`:
- **total** `integer`: Total number of logs matching the query
- **limit** `integer`: No description
- **skip** `integer`: No description
- **pages** `integer`: Total number of pages
- **hasMore** `boolean`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## GET /v1/logs/{logId}
**Get a single log entry**
Retrieve detailed information about a specific log entry, including full request
and response bodies for debugging.
### Parameters
- **logId** (required) in path: The log entry ID
### Responses
#### 200: Log entry retrieved successfully
**Response Body:**
- **log**: `PostLogDetail` - See schema definition
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Forbidden - not authorized to view this log
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
## GET /v1/posts/logs
**Get publishing logs**
Retrieve publishing logs for all posts. Logs show detailed information about each
publishing attempt including API requests, responses, and timing data.
**Filtering:**
- Filter by status (success, failed, pending, skipped)
- Filter by platform (instagram, twitter, linkedin, etc.)
- Filter by action (publish, retry, rate_limit_pause, etc.)
**Retention:** Logs are automatically deleted after 7 days.
### Parameters
- **status** (optional) in query: Filter by log status
- **platform** (optional) in query: Filter by platform
- **action** (optional) in query: Filter by action type
- **days** (optional) in query: Number of days to look back (max 7)
- **limit** (optional) in query: Maximum number of logs to return (max 100)
- **skip** (optional) in query: Number of logs to skip (for pagination)
### Responses
#### 200: Publishing logs retrieved successfully
**Response Body:**
- **logs** `array[PostLog]`:
- **pagination** `object`:
- **total** `integer`: Total number of logs matching the query
- **limit** `integer`: No description
- **skip** `integer`: No description
- **pages** `integer`: Total number of pages
- **hasMore** `boolean`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## GET /v1/connections/logs
**Get connection logs**
Retrieve connection event logs showing account connection and disconnection history.
Useful for debugging OAuth issues and tracking account lifecycle.
**Event Types:**
- `connect_success` - New account connected successfully
- `connect_failed` - Connection attempt failed
- `disconnect` - Account was disconnected
- `reconnect_success` - Existing account reconnected
- `reconnect_failed` - Reconnection attempt failed
**Retention:** Logs are automatically deleted after 7 days.
### Parameters
- **platform** (optional) in query: Filter by platform
- **eventType** (optional) in query: Filter by event type
- **status** (optional) in query: Filter by status (shorthand for event types)
- **days** (optional) in query: Number of days to look back (max 7)
- **limit** (optional) in query: Maximum number of logs to return (max 100)
- **skip** (optional) in query: Number of logs to skip (for pagination)
### Responses
#### 200: Connection logs retrieved successfully
**Response Body:**
- **logs** `array[ConnectionLog]`:
- **pagination** `object`:
- **total** `integer`: Total number of logs matching the query
- **limit** `integer`: No description
- **skip** `integer`: No description
- **pages** `integer`: Total number of pages
- **hasMore** `boolean`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## GET /v1/posts/{postId}/logs
**Get logs for a specific post**
Retrieve all publishing logs for a specific post. Shows the complete history
of publishing attempts for that post across all platforms.
### Parameters
- **postId** (required) in path: The post ID
- **limit** (optional) in query: Maximum number of logs to return (max 100)
### Responses
#### 200: Post logs retrieved successfully
**Response Body:**
- **logs** `array[PostLog]`:
- **count** `integer`: Number of logs returned
- **postId** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Forbidden - not authorized to view this post
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
# Related Schema Definitions
## PostLog
Publishing log entry showing details of a post publishing attempt
### Properties
- **_id** `string`: No description
- **postId**: No description
- **userId** `string`: No description
- **profileId** `string`: No description
- **platform** `string`: No description - one of: tiktok, instagram, facebook, youtube, linkedin, twitter, threads, pinterest, reddit, bluesky, googlebusiness, telegram, snapchat
- **accountId** `string`: No description
- **accountUsername** `string`: No description
- **action** `string`: Type of action logged:
- `publish` - Initial publish attempt
- `retry` - Retry after failure
- `media_upload` - Media upload step
- `rate_limit_pause` - Account paused due to rate limits
- `token_refresh` - Token was refreshed
- `cancelled` - Post was cancelled
- one of: publish, retry, media_upload, rate_limit_pause, token_refresh, cancelled
- **status** `string`: No description - one of: success, failed, pending, skipped
- **statusCode** `integer`: HTTP status code from platform API
- **endpoint** `string`: Platform API endpoint called
- **request** `object`:
- **contentPreview** `string`: First 200 chars of caption
- **mediaCount** `integer`:
- **mediaTypes** `array`:
- **mediaUrls** `array`: URLs of media items sent to platform
- **scheduledFor** `string`:
- **rawBody** `string`: Full request body JSON (max 5000 chars)
- **response** `object`:
- **platformPostId** `string`: ID returned by platform on success
- **platformPostUrl** `string`: URL of published post
- **errorMessage** `string`: Error message on failure
- **errorCode** `string`: Platform-specific error code
- **rawBody** `string`: Full response body JSON (max 5000 chars)
- **durationMs** `integer`: How long the operation took in milliseconds
- **attemptNumber** `integer`: Attempt number (1 for first try, 2+ for retries)
- **createdAt** `string`: No description
## PostLogDetail
## ConnectionLog
Connection event log showing account connection/disconnection history
### Properties
- **_id** `string`: No description
- **userId** `string`: User who owns the connection (may be null for early OAuth failures)
- **profileId** `string`: No description
- **accountId** `string`: The social account ID (present on successful connections and disconnects)
- **platform** `string`: No description - one of: tiktok, instagram, facebook, youtube, linkedin, twitter, threads, pinterest, reddit, bluesky, googlebusiness, telegram, snapchat
- **eventType** `string`: Type of connection event:
- `connect_success` - New account connected successfully
- `connect_failed` - Connection attempt failed
- `disconnect` - Account was disconnected
- `reconnect_success` - Existing account reconnected successfully
- `reconnect_failed` - Reconnection attempt failed
- one of: connect_success, connect_failed, disconnect, reconnect_success, reconnect_failed
- **connectionMethod** `string`: How the connection was initiated - one of: oauth, credentials, invitation
- **error** `object`: Error details (present on failed events)
- **code** `string`: Error code (e.g., oauth_denied, token_exchange_failed)
- **message** `string`: Human-readable error message
- **rawResponse** `string`: Raw error response (truncated to 2000 chars)
- **success** `object`: Success details (present on successful events)
- **displayName** `string`:
- **username** `string`:
- **profilePicture** `string`:
- **permissions** `array`: OAuth scopes/permissions granted
- **tokenExpiresAt** `string`:
- **accountType** `string`: Account type (personal, business, organization)
- **context** `object`: Additional context about the connection attempt
- **isHeadlessMode** `boolean`:
- **hasCustomRedirectUrl** `boolean`:
- **isReconnection** `boolean`:
- **isBYOK** `boolean`: Using bring-your-own-keys
- **invitationToken** `string`:
- **connectToken** `string`:
- **durationMs** `integer`: How long the operation took in milliseconds
- **metadata** `object`: Additional metadata
- **createdAt** `string`: No description
---
# Messages API Reference
Unified inbox API for managing conversations and direct messages across all connected accounts.
All endpoints aggregate data from multiple social accounts in a single API call.
Requires Inbox addon.
## GET /v1/inbox/conversations
**List conversations across all accounts**
Fetch conversations (DMs) from all connected messaging accounts in a single API call.
Supports filtering by profile and platform. Results are aggregated and deduplicated.
**Supported platforms:** Facebook, Instagram, Twitter/X, Bluesky, Reddit, Telegram
### Parameters
- **profileId** (optional) in query: Filter by profile ID
- **platform** (optional) in query: Filter by platform
- **status** (optional) in query: Filter by conversation status
- **sortOrder** (optional) in query: Sort order by updated time
- **limit** (optional) in query: Maximum number of conversations to return
- **cursor** (optional) in query: Pagination cursor for next page
- **accountId** (optional) in query: Filter by specific social account ID
### Responses
#### 200: Aggregated conversations
**Response Body:**
- **data** `array[object]`:
- **id** `string`: No description
- **platform** `string`: No description
- **accountId** `string`: No description
- **accountUsername** `string`: No description
- **participantId** `string`: No description
- **participantName** `string`: No description
- **participantPicture** `string`: No description
- **lastMessage** `string`: No description
- **updatedTime** `string` (date-time): No description
- **status** `string`: No description - one of: active, archived
- **unreadCount** `integer`: Number of unread messages
- **url** `string`: Direct link to open the conversation on the platform (if available)
- **instagramProfile** `object`: Instagram profile data for the participant. Only present for Instagram conversations.
- **isFollower** `boolean`: Whether the participant follows your Instagram business account
- **isFollowing** `boolean`: Whether your Instagram business account follows the participant
- **followerCount** `integer`: The participant's follower count on Instagram
- **isVerified** `boolean`: Whether the participant is a verified Instagram user
- **fetchedAt** `string` (date-time): When this profile data was last fetched from Instagram
- **pagination** `object`:
- **hasMore** `boolean`: No description
- **nextCursor** `string`: No description
- **meta** `object`:
- **accountsQueried** `integer`: No description
- **accountsFailed** `integer`: No description
- **failedAccounts** `array[object]`:
- **accountId** `string`: No description
- **accountUsername** `string`: No description
- **platform** `string`: No description
- **error** `string`: No description
- **code** `string`: Error code if available
- **retryAfter** `integer`: Seconds to wait before retry (rate limits)
- **lastUpdated** `string` (date-time): No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
## GET /v1/inbox/conversations/{conversationId}
**Get conversation details**
Retrieve details and metadata for a specific conversation. Requires accountId query parameter.
### Parameters
- **conversationId** (required) in path: The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
- **accountId** (required) in query: The social account ID
### Responses
#### 200: Conversation details
**Response Body:**
- **data** `object`:
- **id** `string`: No description
- **accountId** `string`: No description
- **accountUsername** `string`: No description
- **platform** `string`: No description
- **status** `string`: No description - one of: active, archived
- **participantName** `string`: No description
- **participantId** `string`: No description
- **lastMessage** `string`: No description
- **lastMessageAt** `string` (date-time): No description
- **updatedTime** `string` (date-time): No description
- **participants** `array[object]`:
- **id** `string`: No description
- **name** `string`: No description
- **instagramProfile** `object`: Instagram profile data for the participant. Only present for Instagram conversations.
- **isFollower** `boolean`: Whether the participant follows your Instagram business account
- **isFollowing** `boolean`: Whether your Instagram business account follows the participant
- **followerCount** `integer`: The participant's follower count on Instagram
- **isVerified** `boolean`: Whether the participant is a verified Instagram user
- **fetchedAt** `string` (date-time): When this profile data was last fetched from Instagram
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
#### 404: Conversation not found
---
## PUT /v1/inbox/conversations/{conversationId}
**Update conversation status**
Archive or activate a conversation. Requires accountId in request body.
### Parameters
- **conversationId** (required) in path: The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
### Request Body
- **accountId** (required) `string`: Social account ID
- **status** (required) `string`: No description - one of: active, archived
### Responses
#### 200: Conversation updated
**Response Body:**
- **success** `boolean`: No description
- **data** `object`:
- **id** `string`: No description
- **accountId** `string`: No description
- **status** `string`: No description - one of: active, archived
- **platform** `string`: No description
- **updatedAt** `string` (date-time): No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
## GET /v1/inbox/conversations/{conversationId}/messages
**Get messages in a conversation**
Fetch messages for a specific conversation. Requires accountId query parameter.
### Parameters
- **conversationId** (required) in path: The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
- **accountId** (required) in query: Social account ID
### Responses
#### 200: Messages in conversation
**Response Body:**
- **status** `string`: No description
- **messages** `array[object]`:
- **id** `string`: No description
- **conversationId** `string`: No description
- **accountId** `string`: No description
- **platform** `string`: No description
- **message** `string`: No description
- **senderId** `string`: No description
- **senderName** `string`: No description
- **direction** `string`: No description - one of: incoming, outgoing
- **createdAt** `string` (date-time): No description
- **attachments** `array[object]`:
- **id** `string`: No description
- **type** `string`: No description - one of: image, video, audio, file, sticker, share
- **url** `string`: No description
- **filename** `string`: No description
- **previewUrl** `string`: No description
- **subject** `string`: Reddit message subject
- **storyReply** `boolean`: Instagram story reply
- **isStoryMention** `boolean`: Instagram story mention
- **lastUpdated** `string` (date-time): No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
## POST /v1/inbox/conversations/{conversationId}/messages
**Send a message**
Send a message in a conversation. Supports text, attachments, quick replies, buttons, carousels, and message tags.
**Attachment support by platform:**
- Telegram: Images, videos, documents (up to 50MB)
- Facebook Messenger: Images, videos, audio, files
- Instagram: Images, videos, audio via URL (8MB images, 25MB video/audio)
- Twitter/X: Images, videos (requires media upload)
- Bluesky: Not supported
- Reddit: Not supported
**Interactive message support:**
| Field | Instagram | Facebook | Telegram |
|---|---|---|---|
| quickReplies | Meta quick_replies (13 max) | Meta quick_replies (13 max) | ReplyKeyboardMarkup (one_time) |
| buttons | Generic template | Generic template | Inline keyboard |
| template | Generic template (carousel) | Generic template (carousel) | Ignored |
| replyMarkup | Ignored | Ignored | InlineKeyboardMarkup / ReplyKeyboardMarkup |
| messagingType | Ignored | RESPONSE / UPDATE / MESSAGE_TAG | Ignored |
| messageTag | HUMAN_AGENT only | 4 tag types | Ignored |
| replyTo | Ignored | Ignored | reply_parameters |
Platform-specific fields are silently ignored on unsupported platforms.
### Parameters
- **conversationId** (required) in path: The conversation ID (id field from list conversations endpoint). This is the platform-specific conversation identifier, not an internal database ID.
### Request Body
- **accountId** (required) `string`: Social account ID
- **message** `string`: Message text
- **quickReplies** `array`: Quick reply buttons. Mutually exclusive with buttons. Max 13 items.
- **buttons** `array`: Action buttons. Mutually exclusive with quickReplies. Max 3 items.
- **template** `object`: Generic template for carousels (Instagram/Facebook only, ignored on Telegram).
- **replyMarkup** `object`: Telegram-native keyboard markup. Ignored on other platforms.
- **messagingType** `string`: Facebook messaging type. Required when using messageTag. - one of: RESPONSE, UPDATE, MESSAGE_TAG
- **messageTag** `string`: Facebook message tag for messaging outside 24h window. Requires messagingType MESSAGE_TAG. Instagram only supports HUMAN_AGENT. - one of: CONFIRMED_EVENT_UPDATE, POST_PURCHASE_UPDATE, ACCOUNT_UPDATE, HUMAN_AGENT
- **replyTo** `string`: Platform message ID to reply to (Telegram only).
### Responses
#### 200: Message sent
**Response Body:**
- **success** `boolean`: No description
- **data** `object`:
- **messageId** `string`: ID of the sent message (not returned for Reddit)
- **conversationId** `string`: Twitter conversation ID
- **sentAt** `string` (date-time): Bluesky sent timestamp
- **message** `string`: Success message (Reddit only)
#### 400: Bad request (e.g., attachment not supported for platform, validation error)
**Response Body:**
- **error** `string`: No description
- **code** `string`: No description - one of: PLATFORM_LIMITATION
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
## PATCH /v1/inbox/conversations/{conversationId}/messages/{messageId}
**Edit a message (Telegram only)**
Edit the text and/or reply markup of a previously sent Telegram message.
Only supported for Telegram. Returns 400 for other platforms.
### Parameters
- **conversationId** (required) in path: The conversation ID
- **messageId** (required) in path: The Telegram message ID to edit
### Request Body
- **accountId** (required) `string`: Social account ID
- **text** `string`: New message text
- **replyMarkup** `object`: New inline keyboard markup
### Responses
#### 200: Message edited
**Response Body:**
- **success** `boolean`: No description
- **data** `object`:
- **messageId** `integer`: No description
#### 400: Not supported or invalid request
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
---
# Platform Settings
Configure Twitter threads, Instagram Stories, TikTok privacy, YouTube visibility, and LinkedIn settings when posting via the Late API.
When creating posts, you can provide platform-specific settings in the `platformSpecificData` field of each `PlatformTarget`. This allows you to customize how your content appears and behaves on each social network.
---
## Twitter/X
Create multi-tweet threads with Twitter's `threadItems` array.
| Property | Type | Description |
|----------|------|-------------|
| `threadItems` | array | Sequence of tweets in a thread. First item is the root tweet. |
| `threadItems[].content` | string | Tweet text content |
| `threadItems[].mediaItems` | array | Media attachments for this tweet |
```json
{
"threadItems": [
{ "content": "🧵 Here's everything you need to know about our API..." },
{ "content": "1/ First, authentication is simple..." },
{ "content": "2/ Next, create your first post..." }
]
}
```
---
## Threads (by Meta)
Similar to Twitter, create multi-post threads on Threads.
| Property | Type | Description |
|----------|------|-------------|
| `threadItems` | array | Sequence of posts (root then replies in order) |
| `threadItems[].content` | string | Post text content |
| `threadItems[].mediaItems` | array | Media attachments for this post |
---
## Facebook
| Property | Type | Description |
|----------|------|-------------|
| `contentType` | `"story"` | Publish as a Facebook Page Story (24-hour ephemeral) |
| `firstComment` | string | Auto-post a first comment (feed posts only, not stories) |
| `pageId` | string | Target Page ID for multi-page posting. Use `GET /v1/accounts/{id}/facebook-page` to list available pages. Uses default page if omitted. |
**Constraints:**
- ❌ Cannot mix videos and images in the same post
- ✅ Up to 10 images for feed posts
- ✅ Stories require media (single image or video)
- ⚠️ Story text captions are not displayed
- ⏱️ Stories disappear after 24 hours
- 📄 Use `pageId` to post to multiple Facebook Pages from the same account connection
```json
{
"contentType": "story",
"pageId": "123456789"
}
```
---
## Instagram
| Property | Type | Description |
|----------|------|-------------|
| `contentType` | `"story"` | Publish as an Instagram Story |
| `shareToFeed` | boolean | For Reels only. When `true` (default), the Reel appears on both the Reels tab and profile feed. Set to `false` for Reels tab only. |
| `collaborators` | string[] | Up to 3 usernames to invite as collaborators (feed/Reels only) |
| `firstComment` | string | Auto-post a first comment (not applied to Stories) |
| `trialParams` | object | Trial Reels configuration (Reels only). Trial Reels are initially shared only with non-followers. |
| `trialParams.graduationStrategy` | `"MANUAL"` \| `"SS_PERFORMANCE"` | `MANUAL`: graduate via Instagram app. `SS_PERFORMANCE`: auto-graduate based on performance. |
| `userTags` | array | Tag users in photos by username and position coordinates |
| `userTags[].username` | string | Instagram username (@ symbol optional, auto-removed) |
| `userTags[].x` | number | X coordinate from left edge (0.0–1.0) |
| `userTags[].y` | number | Y coordinate from top edge (0.0–1.0) |
| `audioName` | string | Custom name for the original audio in Reels. Replaces the default "Original Audio" label. Only applies to Reels (video posts). Can only be set once - either during creation or later from the Instagram audio page in the app. |
| `thumbOffset` | integer | Millisecond offset from the start of the video to use as the Reel thumbnail. Only applies to Reels. If a custom thumbnail URL (`instagramThumbnail` in mediaItems) is provided, it takes priority. Defaults to 0 (first frame). |
**Constraints:**
- 📐 Feed posts require aspect ratio between **0.8** (4:5) and **1.91** (1.91:1)
- 📱 9:16 images must use `contentType: "story"`
- 🎠 Carousels support up to 10 media items
- 🗜️ Images > 8MB auto-compressed
- 📹 Story videos > 100MB auto-compressed
- 🎬 Reel videos > 300MB auto-compressed
- 🏷️ User tags: only for single images or first image of carousels (not stories/videos)
```json
{
"firstComment": "Link in bio! 🔗",
"collaborators": ["brandpartner", "creator123"],
"userTags": [
{ "username": "friend_username", "x": 0.5, "y": 0.5 }
]
}
```
---
## LinkedIn
| Property | Type | Description |
|----------|------|-------------|
| `organizationUrn` | string | Target LinkedIn Organization URN for multi-organization posting. Format: `urn:li:organization:123456789`. Use `GET /v1/accounts/{id}/linkedin-organizations` to list available organizations. Uses default organization if omitted. |
| `firstComment` | string | Auto-post a first comment |
| `disableLinkPreview` | boolean | Set `true` to disable URL previews (default: `false`) |
**Constraints:**
- ✅ Up to 20 images per post
- ❌ Multi-video posts not supported
- 📄 Single PDF document posts supported
- 🔗 Link previews auto-generated when no media attached
- 🏢 Use `organizationUrn` to post to multiple organizations from the same account connection
```json
{
"firstComment": "What do you think? Drop a comment below! 👇",
"disableLinkPreview": false
}
```
---
## Reddit
| Property | Type | Description |
|----------|------|-------------|
| `subreddit` | string | Target subreddit name (without "r/" prefix). Overrides the default subreddit configured on the account connection. |
| `title` | string | Post title (max 300 chars). Defaults to the first line of content, truncated to 300 characters. |
| `url` | string (URI) | URL for link posts. If provided (and forceSelf is not true), creates a link post instead of a text post. |
| `forceSelf` | boolean | When true, creates a text/self post even when a URL or media is provided. |
| `flairId` | string | Flair ID for the post (required by some subreddits). Use `GET /v1/accounts/{id}/reddit-flairs?subreddit=name` to list available flairs. |
---
## Pinterest
| Property | Type | Description |
|----------|------|-------------|
| `title` | string | Pin title (max 100 chars, defaults to first line of content) |
| `boardId` | string | Target board ID (uses first available if omitted) |
| `link` | string (URI) | Destination link for the pin |
| `coverImageUrl` | string (URI) | Cover image for video pins |
| `coverImageKeyFrameTime` | integer | Key frame time in seconds for video cover |
```json
{
"title": "10 Tips for Better Photography",
"boardId": "board-123",
"link": "https://example.com/photography-tips"
}
```
---
## YouTube
| Property | Type | Description |
|----------|------|-------------|
| `title` | string | Video title (max 100 chars, defaults to first line of content) |
| `visibility` | `"public"` \| `"private"` \| `"unlisted"` | Video visibility (default: `public`) |
| `madeForKids` | boolean | COPPA compliance: Set to `true` if video is made for kids (child-directed content). Defaults to `false`. Videos marked as made for kids have restricted features (no comments, no notifications, limited ad targeting). |
| `firstComment` | string | Auto-post a first comment (max 10,000 chars) |
| `tags` | string[] | Tags/keywords for the video (see constraints below) |
| `containsSyntheticMedia` | boolean | AI-generated content disclosure flag. Set to true if your video contains AI-generated or synthetic content that could be mistaken for real people, places, or events. This helps viewers understand when realistic content has been created or altered using AI. YouTube may add a label to videos when this is set. Added to YouTube Data API in October 2024.
| `categoryId` | string | YouTube video category ID. Defaults to `"22"` (People & Blogs). Common categories: `"1"` (Film & Animation), `"2"` (Autos & Vehicles), `"10"` (Music), `"15"` (Pets & Animals), `"17"` (Sports), `"20"` (Gaming), `"22"` (People & Blogs), `"23"` (Comedy), `"24"` (Entertainment), `"25"` (News & Politics), `"26"` (Howto & Style), `"27"` (Education), `"28"` (Science & Technology). |
**Tag Constraints:**
- ✅ No count limit; duplicates are automatically removed
- 📏 Each tag must be ≤ 100 characters
- 📊 Combined total across all tags ≤ 500 characters (YouTube's limit)
**Automatic Detection:**
- ⏱️ Videos ≤ 3 minutes → **YouTube Shorts**
- 🎬 Videos > 3 minutes → **Regular videos**
- 🖼️ Custom thumbnails supported for regular videos only
- ❌ Custom thumbnails NOT supported for Shorts via API
- 👶 `madeForKids` defaults to `false` (not child-directed)
```json
{
"title": "How to Use Our API in 5 Minutes",
"visibility": "public",
"madeForKids": false,
"firstComment": "Thanks for watching! 🙏 Subscribe for more tutorials!"
}
```
---
## TikTok
> ⚠️ **Required Consent**: TikTok posts will fail without `content_preview_confirmed: true` and `express_consent_given: true`.
TikTok settings are nested inside `platformSpecificData.tiktokSettings`:
| Property | Type | Description |
|----------|------|-------------|
| `privacy_level` | string | **Required.** Must be one from your account's available options |
| `allow_comment` | boolean | **Required.** Allow comments on the post |
| `allow_duet` | boolean | Required for video posts |
| `allow_stitch` | boolean | Required for video posts |
| `content_preview_confirmed` | boolean | **Required.** Must be `true` |
| `express_consent_given` | boolean | **Required.** Must be `true` |
| `draft` | boolean | Send to Creator Inbox as draft instead of publishing |
| `description` | string | Long-form description for photo posts (max 4000 chars) |
| `video_cover_timestamp_ms` | integer | Thumbnail frame timestamp in ms (default: 1000) |
| `photo_cover_index` | integer | Cover image index for carousels (0-based, default: 0) |
| `auto_add_music` | boolean | Let TikTok add recommended music (photos only) |
| `video_made_with_ai` | boolean | Disclose AI-generated content |
| `commercial_content_type` | `"none"` \| `"brand_organic"` \| `"brand_content"` | Commercial disclosure |
| `brand_partner_promote` | boolean | Brand partner promotion flag |
| `is_brand_organic_post` | boolean | Brand organic post flag |
| `media_type` | `"video"` \| `"photo"` | Optional override (defaults based on media items) |
**Constraints:**
- 📸 Photo carousels support up to 35 images
- 📝 Video titles: up to 2200 characters
- 📝 Photo titles: auto-truncated to 90 chars (use `description` for longer text)
- 🔒 `privacy_level` must match your account's available options (no defaults)
```json
{
"accountId": "tiktok-012",
"platformSpecificData": {
"tiktokSettings": {
"privacy_level": "PUBLIC_TO_EVERYONE",
"allow_comment": true,
"allow_duet": true,
"allow_stitch": true,
"content_preview_confirmed": true,
"express_consent_given": true,
"description": "Full description here since photo titles are limited to 90 chars..."
}
}
}
```
---
## Google Business Profile
| Property | Type | Description |
|----------|------|-------------|
| `locationId` | string | Target Google Business location ID for multi-location posting. Format: `locations/123456789`. Use `GET /v1/accounts/{id}/gmb-locations` to list available locations. Uses default location if omitted. |
| `languageCode` | string | BCP 47 language code for the post content (e.g., `en`, `de`, `es`, `fr`). If omitted, language is auto-detected from the post text. |
| `callToAction.type` | enum | `LEARN_MORE`, `BOOK`, `ORDER`, `SHOP`, `SIGN_UP`, `CALL` |
| `callToAction.url` | string (URI) | Destination URL for the CTA button |
**Constraints:**
- ✅ Text content + single image only
- ❌ Videos not supported
- 🔗 CTA button drives user engagement
- 📍 Posts appear on Google Search/Maps
- 🗺️ Use `locationId` to post to multiple locations from the same account connection
```json
{
"callToAction": {
"type": "SHOP",
"url": "https://example.com/store"
}
}
```
---
## Telegram
| Property | Type | Description |
|----------|------|-------------|
| `parseMode` | `"HTML"` \| `"Markdown"` \| `"MarkdownV2"` | Text formatting mode (default: `HTML`) |
| `disableWebPagePreview` | boolean | Set `true` to disable link previews |
| `disableNotification` | boolean | Send message silently (no notification sound) |
| `protectContent` | boolean | Prevent forwarding and saving of the message |
**Constraints:**
- 📸 Up to 10 images per post (media album)
- 🎬 Up to 10 videos per post (media album)
- 📝 Text-only posts: up to 4096 characters
- 🖼️ Media captions: up to 1024 characters
- 👤 Channel posts show channel name/logo as author
- 🤖 Group posts show "Late" as the bot author
- 📊 Analytics not available via API (Telegram limitation)
```json
{
"parseMode": "HTML",
"disableWebPagePreview": false,
"disableNotification": false,
"protectContent": true
}
```
---
## Snapchat
| Property | Type | Description |
|----------|------|-------------|
| `contentType` | `"story"` \| `"saved_story"` \| `"spotlight"` | Type of Snapchat content (default: `story`) |
**Content Types:**
- **Story** (default): Ephemeral snap visible for 24 hours. No caption/text supported.
- **Saved Story**: Permanent story saved to your Public Profile. Uses post content as title (max 45 chars).
- **Spotlight**: Video for Snapchat's entertainment feed. Supports description (max 160 chars) with hashtags.
**Constraints:**
- 👤 Requires a Snapchat Public Profile
- 🖼️ Media required for all content types (no text-only posts)
- 1️⃣ Only one media item per post
- 📸 Images: max 20 MB, JPEG/PNG format
- 🎬 Videos: max 500 MB, MP4 format, 5-60 seconds, min 540x960px
- 📐 Aspect ratio: 9:16 recommended
- 🔒 Media is automatically encrypted (AES-256-CBC) before upload
```json
{
"contentType": "saved_story"
}
```
---
## Bluesky
Bluesky doesn't require `platformSpecificData` but has important constraints:
**Constraints:**
- 🖼️ Up to 4 images per post
- 🗜️ Images > ~1MB are automatically recompressed to meet Bluesky's blob size limit
- 🔗 Link previews auto-generated when no media is attached
```json
{
"content": "Just posted this via the Late API! 🦋",
"platforms": [
{
"platform": "bluesky",
"accountId": "bluesky-123"
}
]
}
```
---
## Complete Example
Here's a real-world example posting to multiple platforms with platform-specific settings:
```json
{
"content": "Excited to announce our new product! 🎉",
"mediaItems": [
{ "url": "https://example.com/product.jpg", "type": "image" }
],
"platforms": [
{
"accountId": "twitter-123",
"platformSpecificData": {
"threadItems": [
{ "content": "Excited to announce our new product! 🎉" },
{ "content": "Here's what makes it special... 🧵" }
]
}
},
{
"accountId": "instagram-456",
"platformSpecificData": {
"firstComment": "Link in bio! 🔗",
"collaborators": ["brandpartner"]
}
},
{
"accountId": "linkedin-789",
"platformSpecificData": {
"firstComment": "What features would you like to see next? 👇"
}
},
{
"accountId": "tiktok-012",
"platformSpecificData": {
"tiktokSettings": {
"privacy_level": "PUBLIC_TO_EVERYONE",
"allow_comment": true,
"allow_duet": false,
"allow_stitch": false,
"content_preview_confirmed": true,
"express_consent_given": true
}
}
},
{
"accountId": "youtube-345",
"platformSpecificData": {
"title": "New Product Announcement",
"visibility": "public",
"firstComment": "Thanks for watching! Subscribe for updates! 🔔"
}
},
{
"accountId": "gbp-678",
"platformSpecificData": {
"callToAction": {
"type": "SHOP",
"url": "https://example.com/product"
}
}
},
{
"accountId": "telegram-901",
"platformSpecificData": {
"parseMode": "HTML",
"disableNotification": false,
"protectContent": false
}
},
{
"accountId": "snapchat-234",
"platformSpecificData": {
"contentType": "saved_story"
}
}
]
}
```
---
# Posts API Reference
Create, schedule, update, and delete social media posts across multiple platforms via the Late API
## GET /v1/posts
**List posts visible to the authenticated user**
**Getting Post URLs:**
For published posts, each platform entry includes `platformPostUrl` with the public URL.
Use `status=published` filter to fetch only published posts with their URLs.
Notes and constraints by platform when interpreting the response:
- YouTube: posts always include at least one video in mediaItems.
- Instagram/TikTok: posts always include media; drafts may omit media until finalized in client.
- TikTok: mediaItems will not mix photos and videos in the same post.
### Parameters
- **undefined** (optional): No description
- **undefined** (optional): No description
- **status** (optional) in query: No description
- **platform** (optional) in query: No description
- **profileId** (optional) in query: No description
- **createdBy** (optional) in query: No description
- **dateFrom** (optional) in query: No description
- **dateTo** (optional) in query: No description
- **includeHidden** (optional) in query: No description
### Responses
#### 200: Paginated posts
**Response Body:**
- **posts** `array[Post]`:
- **pagination**: `Pagination` - See schema definition
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## POST /v1/posts
**Create a draft, scheduled, or immediate post**
**Getting Post URLs:**
- For immediate posts (`publishNow: true`): The response includes `platformPostUrl` in each platform entry under `post.platforms[]`.
- For scheduled posts: Fetch the post via `GET /v1/posts/{postId}` after the scheduled time; `platformPostUrl` will be populated once published.
**Content/Caption requirements:**
- `content` (caption/description) is optional when:
- Media is attached (`mediaItems` or per-platform `customMedia`)
- All platforms have `customContent` set
- Posting only to YouTube (title is used instead)
- Text-only posts (no media) require `content`
- Stories do not use captions (content is ignored)
- Reels, feed posts, and other media posts can have optional captions
Platform constraints:
- YouTube requires a video in mediaItems; optional custom thumbnail via MediaItem.thumbnail.
- Instagram and TikTok require media; do not mix videos and images for TikTok.
- Instagram carousels support up to 10 items; Stories publish as 'story'.
- Threads carousels support up to 10 images (no videos in carousels); single posts support one image or video.
- Facebook Stories require media (single image or video); set contentType to 'story' in platformSpecificData.
- LinkedIn multi-image supports up to 20 images; single PDF documents supported (max 100MB, ~300 pages, cannot mix with other media).
- Pinterest supports single image via image_url or a single video per Pin; boardId is required.
- Bluesky supports up to 4 images per post. Images may be automatically recompressed to ≤ ~1MB to satisfy Bluesky's blob limit. When no media is attached, a link preview may be generated for URLs in the text.
- Snapchat requires media (single image or video); set contentType to 'story', 'saved_story', or 'spotlight' in platformSpecificData. Stories are ephemeral (24h), Saved Stories are permanent, Spotlight is for video content.
**Multi-page/multi-location posting:**
Some platforms allow posting to multiple pages, organizations, or locations from a single account connection.
Use the same accountId multiple times with different targets in platformSpecificData:
- Facebook: `pageId` - post to multiple Facebook Pages (list via GET /v1/accounts/{id}/facebook-page)
- LinkedIn: `organizationUrn` - post to multiple organizations (list via GET /v1/accounts/{id}/linkedin-organizations)
- Google Business: `locationId` - post to multiple locations (list via GET /v1/accounts/{id}/gmb-locations)
- Reddit: `subreddit` - post to multiple subreddits from the same account
### Request Body
- **title** `string`: No description
- **content** `string`: Post caption/text content. Optional when media is attached (images, videos, etc.).
Required for text-only posts. Can also be omitted if all platforms have customContent set.
- **mediaItems** `array`: No description
- **platforms** `array`: No description
- **scheduledFor** `string`: No description
- **publishNow** `boolean`: No description
- **isDraft** `boolean`: No description
- **timezone** `string`: No description
- **tags** `array`: Tags/keywords for the post. YouTube-specific constraints:
- No count limit; duplicates are automatically removed
- Each tag must be ≤ 100 characters
- Combined total across all tags ≤ 500 characters (YouTube's limit)
- **hashtags** `array`: No description
- **mentions** `array`: No description
- **crosspostingEnabled** `boolean`: No description
- **metadata** `object`: No description
- **tiktokSettings**: Root-level TikTok settings applied to all TikTok platforms in the request.
This is a convenience shorthand. Settings here are merged into each TikTok
platform's platformSpecificData, with platform-specific settings taking precedence.
- **queuedFromProfile** `string`: Profile ID to schedule via queue.
When provided (without `scheduledFor`), the post will be automatically assigned
to the next available slot from the profile's queue. The system uses distributed
locking to prevent race conditions when multiple posts are scheduled concurrently.
Do not call `/v1/queue/next-slot` and then use that time in `scheduledFor`.
That bypasses the queue system and can cause duplicate slot assignments.
- **queueId** `string`: Specific queue ID to use when scheduling via queue.
Only used when queuedFromProfile is also provided.
If omitted, uses the profile's default queue.
### Responses
#### 201: Post created
**Response Body:**
- **message** `string`: No description
- **post**: `Post` - See schema definition
#### 400: Validation error
**Response Body:**
- **error** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Forbidden
**Response Body:**
- **error** `string`: No description
#### 409: Duplicate content detected
**Response Body:**
- **error** `string`: No description (example: "This exact content was already posted to this account within the last 24 hours.")
- **details** `object`:
- **accountId** `string`: No description
- **platform** `string`: No description
- **existingPostId** `string`: No description
#### 429: Rate limit exceeded. Can be triggered by:
- **API rate limit**: Requests per minute exceeded (Free: 60, Build: 120, Accelerate: 600, Unlimited: 1,200)
- **Velocity limit**: 15 posts per hour per account exceeded
- **Account cooldown**: Account temporarily rate-limited due to repeated errors (escalating: 10min, 20min, 40min, up to 24h)
- **Daily post limit**: Platform daily limits exceeded (X: 20, Pinterest: 25, Instagram/Facebook: 100, Threads: 250, others: 50)
**Response Body:**
- **error** `string`: No description
- **details** `object`: Additional context about the rate limit
---
## GET /v1/posts/{postId}
**Get a single post**
Fetch a single post by ID. For published posts, this returns `platformPostUrl`
for each platform - useful for retrieving post URLs after scheduled posts publish.
### Parameters
- **postId** (required) in path: No description
### Responses
#### 200: Post
**Response Body:**
- **post**: `Post` - See schema definition
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Forbidden
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
## PUT /v1/posts/{postId}
**Update a post**
Update an existing post. Only draft, scheduled, failed, and partial posts can be edited.
Published, publishing, and cancelled posts cannot be modified.
### Parameters
- **postId** (required) in path: No description
### Request Body
- **content** `string`: No description
- **scheduledFor** `string`: No description
- **tiktokSettings**: Root-level TikTok settings applied to all TikTok platforms in the request.
This is a convenience shorthand. Settings here are merged into each TikTok
platform's platformSpecificData, with platform-specific settings taking precedence.
### Responses
#### 200: Post updated
**Response Body:**
- **message** `string`: No description
- **post**: `Post` - See schema definition
#### 207: Partial publish success
#### 400: Invalid request
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Forbidden
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
## DELETE /v1/posts/{postId}
**Delete a post**
Delete a post. Published posts cannot be deleted.
When deleting a scheduled or draft post that consumed upload quota, the quota will be automatically refunded.
### Parameters
- **postId** (required) in path: No description
### Responses
#### 200: Deleted
**Response Body:**
- **message** `string`: No description
#### 400: Cannot delete published posts
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Forbidden
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
## POST /v1/posts/bulk-upload
**Validate and schedule multiple posts from CSV**
### Parameters
- **dryRun** (optional) in query: No description
### Request Body
### Responses
#### 200: Bulk upload results
**Response Body:**
- **success** `boolean`: No description
- **totalRows** `integer`: No description
- **created** `integer`: No description
- **failed** `integer`: No description
- **errors** `array[object]`:
- **row** `integer`: No description
- **error** `string`: No description
- **posts** `array[Post]`:
#### 207: Partial success
#### 400: Invalid CSV or validation errors
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 429: Rate limit exceeded. Can be triggered by:
- **API rate limit**: Requests per minute exceeded
- **Account cooldown**: One or more accounts are temporarily rate-limited
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
## POST /v1/posts/{postId}/retry
**Retry publishing a failed or partial post**
### Parameters
- **postId** (required) in path: No description
### Responses
#### 200: Retry successful
**Response Body:**
- **message** `string`: No description
- **post**: `Post` - See schema definition
#### 207: Partial success
#### 400: Invalid state
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Forbidden
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
#### 409: Post is currently publishing
#### 429: Rate limit exceeded. Can be triggered by:
- **API rate limit**: Requests per minute exceeded
- **Velocity limit**: 15 posts per hour per account exceeded
- **Account cooldown**: Account temporarily rate-limited due to repeated errors
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
# Related Schema Definitions
## PostsListResponse
### Properties
- **posts** `array`: No description
- **pagination**: No description
## Post
### Properties
- **_id** `string`: No description
- **userId**: No description
- **title** `string`: YouTube: title must be ≤ 100 characters.
- **content** `string`: No description
- **mediaItems** `array`: No description
- **platforms** `array`: No description
- **scheduledFor** `string`: No description
- **timezone** `string`: No description
- **status** `string`: No description - one of: draft, scheduled, publishing, published, failed, partial
- **tags** `array`: YouTube tag constraints when targeting YouTube:
- No count cap; duplicates removed.
- Each tag must be ≤ 100 chars.
- Combined characters across all tags ≤ 500.
- **hashtags** `array`: No description
- **mentions** `array`: No description
- **visibility** `string`: No description - one of: public, private, unlisted
- **metadata** `object`: No description
- **queuedFromProfile** `string`: Profile ID if the post was scheduled via the queue
- **queueId** `string`: Queue ID if the post was scheduled via a specific queue
- **createdAt** `string`: No description
- **updatedAt** `string`: No description
## Pagination
### Properties
- **page** `integer`: No description
- **limit** `integer`: No description
- **total** `integer`: No description
- **pages** `integer`: No description
## TikTokPlatformData
TikTok platform-specific settings for video/photo posting.
**Constraints:**
- Photo carousels support up to 35 images.
- **Title length limits**:
- Videos: up to 2200 chars (full content used as title)
- Photos: content is automatically truncated to 90 chars for title (hashtags/URLs stripped). Use 'description' field for longer text (up to 4000 chars).
- privacyLevel must be chosen from creator_info.privacy_level_options (no defaulting).
- allowDuet and allowStitch required for videos; allowComment for all.
- contentPreviewConfirmed and expressConsentGiven must be true before posting.
**Note:** Both camelCase and snake_case field names are accepted for backwards compatibility.
The nested `tiktokSettings` object format is also still supported but deprecated.
### Properties
- **draft** `boolean`: When true, Late sends the post to the TikTok Creator Inbox as a draft instead of publishing it immediately. When omitted or false, TikTok uses direct posting (live publish) as usual.
- **privacyLevel** `string`: One of the values returned by the TikTok creator info API for the account
- **allowComment** `boolean`: Allow comments on the post
- **allowDuet** `boolean`: Allow duets (required for video posts)
- **allowStitch** `boolean`: Allow stitches (required for video posts)
- **commercialContentType** `string`: Type of commercial content disclosure - one of: none, brand_organic, brand_content
- **brandPartnerPromote** `boolean`: Whether the post promotes a brand partner
- **isBrandOrganicPost** `boolean`: Whether the post is a brand organic post
- **contentPreviewConfirmed** `boolean`: User has confirmed they previewed the content
- **expressConsentGiven** `boolean`: User has given express consent for posting
- **mediaType** `string`: Optional override. Defaults based on provided media items. - one of: video, photo
- **videoCoverTimestampMs** `integer`: Optional for video posts. Timestamp in milliseconds to select which frame to use as thumbnail (defaults to 1000ms/1 second). (min: 0)
- **photoCoverIndex** `integer`: Optional for photo carousels. Index of image to use as cover, 0-based (defaults to 0/first image). (min: 0)
- **autoAddMusic** `boolean`: When true, TikTok may add recommended music (photos only)
- **videoMadeWithAi** `boolean`: Set true to disclose AI-generated content
- **description** `string`: Optional long-form description for photo posts (max 4000 chars).
Recommended for photo posts when content exceeds 90 characters, as photo titles are automatically truncated to 90 chars (after stripping hashtags/URLs).
(max: 4000)
## PostCreateResponse
### Properties
- **message** `string`: No description
- **post**: No description
## PostGetResponse
### Properties
- **post**: No description
## PostUpdateResponse
### Properties
- **message** `string`: No description
- **post**: No description
## PostDeleteResponse
### Properties
- **message** `string`: No description
## PostRetryResponse
### Properties
- **message** `string`: No description
- **post**: No description
---
# Profiles API Reference
Create and manage profiles to organize connected social media accounts with the Late API
## GET /v1/profiles
**List profiles visible to the authenticated user**
Returns profiles within the user's plan limit. Profiles are sorted by creation date (oldest first).
Use `includeOverLimit=true` to include profiles that exceed the plan limit (for management/deletion purposes).
### Parameters
- **includeOverLimit** (optional) in query: When true, includes profiles that exceed the user's plan limit.
Over-limit profiles will have `isOverLimit: true` in the response.
Useful for managing/deleting profiles after a plan downgrade.
### Responses
#### 200: Profiles
**Response Body:**
- **profiles** `array[Profile]`:
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## POST /v1/profiles
**Create a new profile**
### Request Body
- **name** (required) `string`: No description
- **description** `string`: No description
- **color** `string`: No description
### Responses
#### 201: Created
**Response Body:**
- **message** `string`: No description
- **profile**: `Profile` - See schema definition
#### 400: Invalid request
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Profile limit exceeded
---
## GET /v1/profiles/{profileId}
**Get a profile by id**
### Parameters
- **profileId** (required) in path: No description
### Responses
#### 200: Profile
**Response Body:**
- **profile**: `Profile` - See schema definition
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
## PUT /v1/profiles/{profileId}
**Update a profile**
### Parameters
- **profileId** (required) in path: No description
### Request Body
- **name** `string`: No description
- **description** `string`: No description
- **color** `string`: No description
- **isDefault** `boolean`: No description
### Responses
#### 200: Updated
**Response Body:**
- **message** `string`: No description
- **profile**: `Profile` - See schema definition
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
## DELETE /v1/profiles/{profileId}
**Delete a profile (must have no connected accounts)**
### Parameters
- **profileId** (required) in path: No description
### Responses
#### 200: Deleted
**Response Body:**
- **message** `string`: No description
#### 400: Has connected accounts
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Forbidden
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
# Related Schema Definitions
## ProfilesListResponse
### Properties
- **profiles** `array`: No description
## Profile
### Properties
- **_id** `string`: No description
- **userId** `string`: No description
- **name** `string`: No description
- **description** `string`: No description
- **color** `string`: No description
- **isDefault** `boolean`: No description
- **isOverLimit** `boolean`: Only present when `includeOverLimit=true` is used. Indicates if this profile
exceeds the user's plan limit. Over-limit profiles cannot be used for posting
but can be managed (disconnected accounts, deleted).
- **createdAt** `string`: No description
## ProfileCreateResponse
### Properties
- **message** `string`: No description
- **profile**: No description
---
# Reviews API Reference
Unified inbox API for managing reviews on Facebook Pages and Google Business accounts.
All endpoints aggregate data from multiple social accounts in a single API call.
Requires Inbox addon.
## GET /v1/inbox/reviews
**List reviews across all accounts**
Fetch reviews from all connected Facebook Pages and Google Business accounts.
Aggregates data with filtering and sorting options.
**Supported platforms:** Facebook, Google Business
### Parameters
- **profileId** (optional) in query: No description
- **platform** (optional) in query: No description
- **minRating** (optional) in query: No description
- **maxRating** (optional) in query: No description
- **hasReply** (optional) in query: Filter by reply status
- **sortBy** (optional) in query: No description
- **sortOrder** (optional) in query: No description
- **limit** (optional) in query: No description
- **cursor** (optional) in query: No description
- **accountId** (optional) in query: Filter by specific social account ID
### Responses
#### 200: Aggregated reviews
**Response Body:**
- **status** `string`: No description
- **data** `array[object]`:
- **id** `string`: No description
- **platform** `string`: No description
- **accountId** `string`: No description
- **accountUsername** `string`: No description
- **reviewer** `object`:
- **id** `string`: No description
- **name** `string`: No description
- **profileImage** `string`: No description
- **rating** `integer`: No description
- **text** `string`: No description
- **created** `string` (date-time): No description
- **hasReply** `boolean`: No description
- **reply** `object`:
- **id** `string`: No description
- **text** `string`: No description
- **created** `string` (date-time): No description
- **reviewUrl** `string`: No description
- **pagination** `object`:
- **hasMore** `boolean`: No description
- **nextCursor** `string`: No description
- **meta** `object`:
- **accountsQueried** `integer`: No description
- **accountsFailed** `integer`: No description
- **failedAccounts** `array[object]`:
- **accountId** `string`: No description
- **accountUsername** `string`: No description
- **platform** `string`: No description
- **error** `string`: No description
- **code** `string`: Error code if available
- **retryAfter** `integer`: Seconds to wait before retry (rate limits)
- **lastUpdated** `string` (date-time): No description
- **summary** `object`:
- **totalReviews** `integer`: No description
- **averageRating** `number`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
## POST /v1/inbox/reviews/{reviewId}/reply
**Reply to a review**
Post a reply to a review. Requires accountId in request body.
### Parameters
- **reviewId** (required) in path: Review ID (URL-encoded for Google Business)
### Request Body
- **accountId** (required) `string`: No description
- **message** (required) `string`: No description
### Responses
#### 200: Reply posted
**Response Body:**
- **status** `string`: No description
- **reply** `object`:
- **id** `string`: No description
- **text** `string`: No description
- **created** `string` (date-time): No description
- **platform** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
## DELETE /v1/inbox/reviews/{reviewId}/reply
**Delete a review reply**
Delete a reply to a review (Google Business only). Requires accountId in request body.
### Parameters
- **reviewId** (required) in path: No description
### Request Body
- **accountId** (required) `string`: No description
### Responses
#### 200: Reply deleted
**Response Body:**
- **status** `string`: No description
- **message** `string`: No description
- **platform** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Inbox addon required
---
---
# Webhooks API Reference
Configure webhooks to receive real-time notifications about post status changes, account events, and incoming messages.
**Available Events:**
- `post.scheduled` - When a post is successfully scheduled
- `post.published` - When a post is successfully published
- `post.failed` - When a post fails to publish on all platforms
- `post.partial` - When a post publishes to some platforms but fails on others
- `account.connected` - When a social account is successfully connected
- `account.disconnected` - When a social account is disconnected (token expired/revoked)
- `message.received` - When a new DM is received (Instagram, Telegram)
**Security:**
- Optional HMAC-SHA256 signature sent in `X-Late-Signature` header
- Configure a secret key in webhook settings to enable signature verification
- Custom headers can be added to webhook requests for additional authentication
## GET /v1/webhooks/settings
**List all webhooks**
Retrieve all configured webhooks for the authenticated user. Supports up to 10 webhooks per user.
### Responses
#### 200: Webhooks retrieved successfully
**Response Body:**
- **webhooks** `array[Webhook]`:
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## POST /v1/webhooks/settings
**Create a new webhook**
Create a new webhook configuration. Maximum 10 webhooks per user.
**Note:** Webhooks are automatically disabled after 10 consecutive delivery failures.
### Request Body
- **name** `string`: Webhook name (max 50 characters)
- **url** `string`: Webhook endpoint URL (must be HTTPS in production)
- **secret** `string`: Secret key for HMAC-SHA256 signature verification
- **events** `array`: Events to subscribe to
- **isActive** `boolean`: Enable or disable webhook delivery
- **customHeaders** `object`: Custom headers to include in webhook requests
### Responses
#### 200: Webhook created successfully
**Response Body:**
- **success** `boolean`: No description
- **webhook**: `Webhook` - See schema definition
#### 400: Validation error or maximum webhooks reached
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## PUT /v1/webhooks/settings
**Update a webhook**
Update an existing webhook configuration. All fields except `_id` are optional - only provided fields will be updated.
**Note:** Webhooks are automatically disabled after 10 consecutive delivery failures.
### Request Body
- **_id** (required) `string`: Webhook ID to update (required)
- **name** `string`: Webhook name (max 50 characters)
- **url** `string`: Webhook endpoint URL (must be HTTPS in production)
- **secret** `string`: Secret key for HMAC-SHA256 signature verification
- **events** `array`: Events to subscribe to
- **isActive** `boolean`: Enable or disable webhook delivery
- **customHeaders** `object`: Custom headers to include in webhook requests
### Responses
#### 200: Webhook updated successfully
**Response Body:**
- **success** `boolean`: No description
- **webhook**: `Webhook` - See schema definition
#### 400: Validation error or missing webhook ID
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Webhook not found
---
## DELETE /v1/webhooks/settings
**Delete a webhook**
Permanently delete a webhook configuration.
### Parameters
- **id** (required) in query: Webhook ID to delete
### Responses
#### 200: Webhook deleted successfully
**Response Body:**
- **success** `boolean`: No description
#### 400: Webhook ID required
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## POST /v1/webhooks/test
**Send test webhook**
Send a test webhook to verify your endpoint is configured correctly.
The test payload includes `event: "webhook.test"` to distinguish it from real events.
### Request Body
- **webhookId** (required) `string`: ID of the webhook to test
### Responses
#### 200: Test webhook sent successfully
**Response Body:**
- **success** `boolean`: No description
- **message** `string`: No description
#### 400: Webhook ID required
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 500: Test webhook failed to deliver
**Response Body:**
- **success** `boolean`: No description
- **message** `string`: No description
---
## GET /v1/webhooks/logs
**Get webhook delivery logs**
Retrieve webhook delivery history. Logs are automatically deleted after 7 days.
### Parameters
- **limit** (optional) in query: Maximum number of logs to return (max 100)
- **status** (optional) in query: Filter by delivery status
- **event** (optional) in query: Filter by event type
- **webhookId** (optional) in query: Filter by webhook ID
### Responses
#### 200: Webhook logs retrieved successfully
**Response Body:**
- **logs** `array[WebhookLog]`:
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
# Related Schema Definitions
## Webhook
Individual webhook configuration for receiving real-time notifications
### Properties
- **_id** `string`: Unique webhook identifier
- **name** `string`: Webhook name (for identification) (max: 50)
- **url** `string`: Webhook endpoint URL
- **secret** `string`: Secret key for HMAC-SHA256 signature (not returned in responses for security)
- **events** `array`: Events subscribed to
- **isActive** `boolean`: Whether webhook delivery is enabled
- **lastFiredAt** `string`: Timestamp of last successful webhook delivery
- **failureCount** `integer`: Consecutive delivery failures (resets on success, webhook disabled at 10)
- **customHeaders** `object`: Custom headers included in webhook requests
## WebhookLog
Webhook delivery log entry
### Properties
- **_id** `string`: No description
- **webhookId** `string`: ID of the webhook that was triggered
- **webhookName** `string`: Name of the webhook that was triggered
- **event** `string`: No description - one of: post.scheduled, post.published, post.failed, post.partial, account.connected, account.disconnected, message.received, webhook.test
- **url** `string`: No description
- **status** `string`: No description - one of: success, failed
- **statusCode** `integer`: HTTP status code from webhook endpoint
- **requestPayload** `object`: Payload sent to webhook endpoint
- **responseBody** `string`: Response body from webhook endpoint (truncated to 10KB)
- **errorMessage** `string`: Error message if delivery failed
- **attemptNumber** `integer`: Delivery attempt number (max 3 retries)
- **responseTime** `integer`: Response time in milliseconds
- **createdAt** `string`: No description
---
# Account Groups API Reference
Organize social media accounts into groups for team collaboration and management
## GET /v1/account-groups
**List account groups for the authenticated user**
### Responses
#### 200: Groups
**Response Body:**
- **groups** `array[object]`:
- **_id** `string`: No description
- **name** `string`: No description
- **accountIds** `array[string]`:
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## POST /v1/account-groups
**Create a new account group**
### Request Body
- **name** (required) `string`: No description
- **accountIds** (required) `array`: No description
### Responses
#### 201: Created
**Response Body:**
- **message** `string`: No description
- **group** `object`:
- **_id** `string`: No description
- **name** `string`: No description
- **accountIds** `array[string]`:
#### 400: Invalid request
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 409: Group name already exists
---
## PUT /v1/account-groups/{groupId}
**Update an account group**
### Parameters
- **groupId** (required) in path: No description
### Request Body
- **name** `string`: No description
- **accountIds** `array`: No description
### Responses
#### 200: Updated
**Response Body:**
- **message** `string`: No description
- **group** `object`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
#### 409: Group name already exists
---
## DELETE /v1/account-groups/{groupId}
**Delete an account group**
### Parameters
- **groupId** (required) in path: No description
### Responses
#### 200: Deleted
**Response Body:**
- **message** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
---
# API Keys API Reference
Generate, rotate, and manage API keys for authenticating Late API requests
## GET /v1/api-keys
**List API keys for the current user**
### Responses
#### 200: API keys
**Response Body:**
- **apiKeys** `array[ApiKey]`:
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## POST /v1/api-keys
**Create a new API key**
### Request Body
- **name** (required) `string`: No description
- **expiresIn** `integer`: Days until expiry
### Responses
#### 201: Created
**Response Body:**
- **message** `string`: No description
- **apiKey**: `ApiKey` - See schema definition
#### 400: Invalid request
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## DELETE /v1/api-keys/{keyId}
**Delete an API key**
### Parameters
- **keyId** (required) in path: No description
### Responses
#### 200: Deleted
**Response Body:**
- **message** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
# Related Schema Definitions
## ApiKey
### Properties
- **id** `string`: No description
- **name** `string`: No description
- **keyPreview** `string`: No description
- **expiresAt** `string`: No description
- **createdAt** `string`: No description
- **key** `string`: Returned only once, on creation
---
# Invites API Reference
Send and manage team invitations for collaborative social media management
## POST /v1/invite/tokens
**Create a team member invite token**
Generate a secure invite link to grant team members access to your profiles.
Invites expire after 7 days and are single-use.
### Request Body
- **scope** (required) `string`: 'all' grants access to all profiles, 'profiles' restricts to specific profiles - one of: all, profiles
- **profileIds** `array`: Required if scope is 'profiles'. Array of profile IDs to grant access to.
### Responses
#### 201: Invite token created
**Response Body:**
- **token** `string`: No description
- **scope** `string`: No description
- **invitedProfileIds** `array[string]`:
- **expiresAt** `string` (date-time): No description
- **inviteUrl** `string` (uri): No description
#### 400: Invalid request
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: One or more profiles not found or not owned
---
---
# Users API Reference
Manage team user accounts, permissions, and retrieve user information via the Late API
## GET /v1/users
**List team users (root + invited)**
### Responses
#### 200: Users
**Response Body:**
- **currentUserId** `string`: No description
- **users** `array[object]`:
- **_id** `string`: No description
- **name** `string`: No description
- **email** `string`: No description
- **role** `string`: No description
- **isRoot** `boolean`: No description
- **profileAccess** `array[string]`:
- **createdAt** `string` (date-time): No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## GET /v1/users/{userId}
**Get user by id (self or invited)**
### Parameters
- **userId** (required) in path: No description
### Responses
#### 200: User
**Response Body:**
- **user** `object`:
- **_id** `string`: No description
- **name** `string`: No description
- **email** `string`: No description
- **role** `string`: No description
- **isRoot** `boolean`: No description
- **profileAccess** `array[string]`:
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Forbidden
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
---
# Media Downloads API Reference
Download videos from YouTube, Instagram, TikTok, Twitter/X, Facebook, LinkedIn, and Bluesky
## GET /v1/tools/youtube/download
**Download YouTube video or audio**
Download YouTube videos or audio. Returns available formats or direct download URL.
**Rate Limits:** Build (50/day), Accelerate (500/day), Unlimited (unlimited)
### Parameters
- **url** (required) in query: YouTube video URL or video ID
- **action** (optional) in query: Action to perform: 'download' returns download URL, 'formats' lists available formats
- **format** (optional) in query: Desired format (when action=download)
- **quality** (optional) in query: Desired quality (when action=download)
- **formatId** (optional) in query: Specific format ID from formats list
### Responses
#### 200: Success
**Response Body:**
- **success** `boolean`: No description
- **title** `string`: No description
- **downloadUrl** `string` (uri): No description
- **formats** `array[object]`:
- **id** `string`: No description
- **label** `string`: No description
- **ext** `string`: No description
- **type** `string`: No description
- **height** `integer`: No description
- **width** `integer`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 403: Tools API not available on free plan
#### 429: Daily rate limit exceeded
---
## GET /v1/tools/instagram/download
**Download Instagram reel or post**
Download Instagram reels, posts, or photos.
**Rate Limits:** Build (50/day), Accelerate (500/day), Unlimited (unlimited)
### Parameters
- **url** (required) in query: Instagram reel or post URL
### Responses
#### 200: Success
**Response Body:**
- **success** `boolean`: No description
- **title** `string`: No description
- **downloadUrl** `string` (uri): No description
---
## GET /v1/tools/tiktok/download
**Download TikTok video**
Download TikTok videos with or without watermark.
**Rate Limits:** Build (50/day), Accelerate (500/day), Unlimited (unlimited)
### Parameters
- **url** (required) in query: TikTok video URL or ID
- **action** (optional) in query: 'formats' to list available formats
- **formatId** (optional) in query: Specific format ID (0 = no watermark, etc.)
### Responses
#### 200: Success
**Response Body:**
- **success** `boolean`: No description
- **title** `string`: No description
- **downloadUrl** `string` (uri): No description
- **formats** `array[object]`:
- **id** `string`: No description
- **label** `string`: No description
- **ext** `string`: No description
---
## GET /v1/tools/twitter/download
**Download Twitter/X video**
Download videos from Twitter/X posts.
**Rate Limits:** Build (50/day), Accelerate (500/day), Unlimited (unlimited)
### Parameters
- **url** (required) in query: Twitter/X post URL
- **action** (optional) in query: No description
- **formatId** (optional) in query: No description
### Responses
#### 200: Success
**Response Body:**
- **success** `boolean`: No description
- **title** `string`: No description
- **downloadUrl** `string` (uri): No description
---
## GET /v1/tools/facebook/download
**Download Facebook video**
Download videos and reels from Facebook.
**Rate Limits:** Build (50/day), Accelerate (500/day), Unlimited (unlimited)
### Parameters
- **url** (required) in query: Facebook video or reel URL
### Responses
#### 200: Success
**Response Body:**
- **success** `boolean`: No description
- **title** `string`: No description
- **downloadUrl** `string` (uri): No description
- **thumbnail** `string` (uri): No description
---
## GET /v1/tools/linkedin/download
**Download LinkedIn video**
Download videos from LinkedIn posts.
**Rate Limits:** Build (50/day), Accelerate (500/day), Unlimited (unlimited)
### Parameters
- **url** (required) in query: LinkedIn post URL
### Responses
#### 200: Success
**Response Body:**
- **success** `boolean`: No description
- **title** `string`: No description
- **downloadUrl** `string` (uri): No description
---
## GET /v1/tools/bluesky/download
**Download Bluesky video**
Download videos from Bluesky posts.
**Rate Limits:** Build (50/day), Accelerate (500/day), Unlimited (unlimited)
### Parameters
- **url** (required) in query: Bluesky post URL
### Responses
#### 200: Success
**Response Body:**
- **success** `boolean`: No description
- **title** `string`: No description
- **text** `string`: No description
- **downloadUrl** `string` (uri): No description
- **thumbnail** `string` (uri): No description
---
---
# Hashtag Checker API Reference
Check Instagram hashtags for bans and restrictions before posting
## POST /v1/tools/instagram/hashtag-checker
**Check Instagram hashtags for bans**
Check if Instagram hashtags are banned, restricted, or safe to use.
**Rate Limits:** Build (50/day), Accelerate (500/day), Unlimited (unlimited)
### Request Body
- **hashtags** (required) `array`: No description
### Responses
#### 200: Success
**Response Body:**
- **success** `boolean`: No description
- **results** `array[object]`:
- **hashtag** `string`: No description
- **status** `string`: No description - one of: banned, restricted, safe, unknown
- **reason** `string`: No description
- **confidence** `number`: No description
- **summary** `object`:
- **banned** `integer`: No description
- **restricted** `integer`: No description
- **safe** `integer`: No description
---
---
# Overview
Media download and utility tools for social media content
The Tools API provides media download and utility features for working with social media content. These endpoints help you download videos, extract transcripts, check hashtags, and generate AI captions.
**Paid Plans Only:** Tools API endpoints are available to Build, Accelerate, and Unlimited plans.
---
## Rate Limits
All Tools API endpoints are rate-limited based on your plan:
| Plan | Daily Limit |
|------|-------------|
| Build | 50 requests/day |
| Accelerate | 500 requests/day |
| Unlimited | Unlimited |
Rate limit headers are included in all responses:
| Header | Description |
|--------|-------------|
| `X-RateLimit-Limit` | Your daily limit |
| `X-RateLimit-Remaining` | Remaining requests today |
| `X-RateLimit-Reset` | Unix timestamp when limit resets |
---
## Available Tools
- **[Media Downloads](/tools/downloads)** — Download videos from YouTube, Instagram, TikTok, Twitter/X, Facebook, LinkedIn, Bluesky
- **[Transcripts](/tools/transcripts)** — Extract transcripts from YouTube videos
- **[Hashtag Checker](/tools/hashtag-checker)** — Check Instagram hashtags for bans
---
## Error Responses
| Status | Description |
|--------|-------------|
| `401` | Unauthorized — Invalid or missing API key |
| `403` | Forbidden — Tools API not available on your plan |
| `429` | Rate limit exceeded — Wait until reset time |
| `404` | Not found — Content unavailable or URL invalid |
---
# Transcripts API Reference
Extract transcripts and captions from YouTube videos
## GET /v1/tools/youtube/transcript
**Get YouTube video transcript**
Extract transcript/captions from a YouTube video.
**Rate Limits:** Build (50/day), Accelerate (500/day), Unlimited (unlimited)
### Parameters
- **url** (required) in query: YouTube video URL or video ID
- **lang** (optional) in query: Language code for transcript
### Responses
#### 200: Success
**Response Body:**
- **success** `boolean`: No description
- **videoId** `string`: No description
- **language** `string`: No description
- **fullText** `string`: No description
- **segments** `array[object]`:
- **text** `string`: No description
- **start** `number`: No description
- **duration** `number`: No description
#### 404: No transcript available
---
---
# GMB Attributes API Reference
Manage Google Business Profile location attributes like amenities, services, and accessibility features via the Late API
## GET /v1/accounts/{accountId}/gmb-attributes
**Get Google Business Profile location attributes**
Fetches location attributes such as amenities, services, and accessibility features.
Common attributes for restaurants include:
- Dining options: has_dine_in, has_takeout, has_delivery
- Amenities: has_outdoor_seating, has_wifi, has_parking
- Accessibility: has_wheelchair_accessible_entrance
- Payments: pay_credit_card_types_accepted
Available attributes vary by business category.
### Parameters
- **accountId** (required) in path: No description
### Responses
#### 200: Attributes fetched successfully
**Response Body:**
- **success** `boolean`: No description
- **accountId** `string`: No description
- **locationId** `string`: No description
- **attributes** `array[object]`:
- **name** `string`: Attribute identifier (e.g. has_delivery)
- **valueType** `string`: Value type (BOOL, ENUM, URL, REPEATED_ENUM)
- **values** `array[items]`:
- **repeatedEnumValue** `object`:
- **setValues** `array[string]`:
- **unsetValues** `array[string]`:
#### 400: Invalid request
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
## PUT /v1/accounts/{accountId}/gmb-attributes
**Update Google Business Profile location attributes**
Updates location attributes (amenities, services, etc.).
The `attributeMask` specifies which attributes to update (comma-separated).
### Parameters
- **accountId** (required) in path: No description
### Request Body
- **attributes** (required) `array`: No description
- **attributeMask** (required) `string`: Comma-separated attribute names to update (e.g. 'has_delivery,has_takeout')
### Responses
#### 200: Attributes updated successfully
**Response Body:**
- **success** `boolean`: No description
- **accountId** `string`: No description
- **locationId** `string`: No description
- **attributes** `array[object]`:
Type: `object`
#### 400: Invalid request
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
# Related Schema Definitions
## ErrorResponse
### Properties
- **error** `string`: No description
- **details** `object`: No description
---
# GMB Food Menus API Reference
Manage food menus for Google Business Profile locations including sections, items, pricing, and dietary info via the Late API
## GET /v1/accounts/{accountId}/gmb-food-menus
**Get Google Business Profile food menus**
Fetches food menus for a connected Google Business Profile location.
Returns the full menu structure including:
- Menu names and descriptions
- Sections (e.g. Appetizers, Entrees, Drinks)
- Items with labels, pricing, dietary info, and allergens
- Item options/variants
Only available for locations with food menu support (restaurants, cafes, etc.).
### Parameters
- **accountId** (required) in path: The Late account ID (from /v1/accounts)
### Responses
#### 200: Food menus fetched successfully
**Response Body:**
- **success** `boolean`: No description
- **accountId** `string`: No description
- **locationId** `string`: No description
- **name** `string`: Resource name of the food menus
- **menus** `array[FoodMenu]`:
#### 400: Invalid request - not a Google Business account or missing location
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 401: Unauthorized or token expired
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 403: Permission denied for this location
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
#### 500: Failed to fetch food menus
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
## PUT /v1/accounts/{accountId}/gmb-food-menus
**Update Google Business Profile food menus**
Updates the food menus for a connected Google Business Profile location.
Send the full menus array. Use `updateMask` for partial updates (e.g. `"menus"` to only update the menus field).
Each menu can contain sections, and each section can contain items with pricing, dietary restrictions, allergens, and more.
### Parameters
- **accountId** (required) in path: The Late account ID (from /v1/accounts)
### Request Body
- **menus** (required) `array`: Array of food menus to set
- **updateMask** `string`: Field mask for partial updates (e.g. "menus")
### Responses
#### 200: Food menus updated successfully
**Response Body:**
- **success** `boolean`: No description
- **accountId** `string`: No description
- **locationId** `string`: No description
- **name** `string`: No description
- **menus** `array[FoodMenu]`:
#### 400: Invalid request
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 401: Unauthorized or token expired
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 403: Permission denied for this location
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
#### 500: Failed to update food menus
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
# Related Schema Definitions
## FoodMenu
### Properties
- **labels** (required) `array`: No description
- **sections** `array`: No description
- **cuisines** `array`: Cuisine types (e.g. AMERICAN, ITALIAN, JAPANESE)
- **sourceUrl** `string`: URL of the original menu source
## ErrorResponse
### Properties
- **error** `string`: No description
- **details** `object`: No description
---
# GMB Location Details API Reference
Read and update Google Business Profile location details including hours, special hours, description, and contact info via the Late API
## GET /v1/accounts/{accountId}/gmb-location-details
**Get Google Business Profile location details**
Fetches detailed location information including opening hours, special hours,
business description, phone numbers, website, categories, and more.
Use the `readMask` query parameter to request specific fields.
### Parameters
- **accountId** (required) in path: The Late account ID (from /v1/accounts)
- **readMask** (optional) in query: Comma-separated fields to return. Defaults to common fields.
Available: name, title, phoneNumbers, categories, storefrontAddress, websiteUri,
regularHours, specialHours, serviceArea, profile, openInfo, metadata, moreHours
### Responses
#### 200: Location details fetched successfully
**Response Body:**
- **success** `boolean`: No description
- **accountId** `string`: No description
- **locationId** `string`: No description
- **title** `string`: Business name
- **regularHours** `object`:
- **periods** `array[object]`:
- **openDay** `string`: No description - one of: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY
- **openTime** `string`: Opening time in HH:MM format
- **closeDay** `string`: No description
- **closeTime** `string`: No description
- **specialHours** `object`:
- **specialHourPeriods** `array[object]`:
- **startDate** `object`:
- **year** `integer`: No description
- **month** `integer`: No description
- **day** `integer`: No description
- **endDate** `object`:
- **year** `integer`: No description
- **month** `integer`: No description
- **day** `integer`: No description
- **openTime** `string`: No description
- **closeTime** `string`: No description
- **closed** `boolean`: No description
- **profile** `object`:
- **description** `string`: Business description
- **websiteUri** `string`: No description
- **phoneNumbers** `object`:
- **primaryPhone** `string`: No description
- **additionalPhones** `array[string]`:
#### 400: Invalid request
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 401: Unauthorized or token expired
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
## PUT /v1/accounts/{accountId}/gmb-location-details
**Update Google Business Profile location details**
Updates location details such as opening hours, special hours, business description, phone, and website.
The `updateMask` field is required and specifies which fields to update.
Common update masks:
- `regularHours` - Update opening hours
- `specialHours` - Update holiday/special hours
- `profile.description` - Update business description
- `websiteUri` - Update website URL
- `phoneNumbers` - Update phone numbers
- `regularHours,specialHours` - Update both at once
### Parameters
- **accountId** (required) in path: The Late account ID (from /v1/accounts)
### Request Body
- **updateMask** (required) `string`: Required. Comma-separated fields to update (e.g. 'regularHours', 'specialHours', 'profile.description')
- **regularHours** `object`: No description
- **specialHours** `object`: No description
- **profile** `object`: No description
- **websiteUri** `string`: No description
- **phoneNumbers** `object`: No description
### Responses
#### 200: Location updated successfully
**Response Body:**
- **success** `boolean`: No description
- **accountId** `string`: No description
- **locationId** `string`: No description
#### 400: Invalid request or missing updateMask
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 401: Unauthorized or token expired
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
# Related Schema Definitions
## ErrorResponse
### Properties
- **error** `string`: No description
- **details** `object`: No description
---
# GMB Media API Reference
Upload, list, and delete photos for Google Business Profile locations via the Late API
## GET /v1/accounts/{accountId}/gmb-media
**List Google Business Profile media (photos)**
Lists media items (photos) for a Google Business Profile location.
Returns photo URLs, descriptions, categories, and metadata.
### Parameters
- **accountId** (required) in path: No description
- **pageSize** (optional) in query: Number of items to return (max 100)
- **pageToken** (optional) in query: Pagination token from previous response
### Responses
#### 200: Media items fetched successfully
**Response Body:**
- **success** `boolean`: No description
- **accountId** `string`: No description
- **locationId** `string`: No description
- **mediaItems** `array[object]`:
- **name** `string`: Resource name
- **mediaFormat** `string`: No description - one of: PHOTO, VIDEO
- **sourceUrl** `string`: No description
- **googleUrl** `string`: Google-hosted URL
- **thumbnailUrl** `string`: No description
- **description** `string`: No description
- **createTime** `string` (date-time): No description
- **locationAssociation** `object`:
- **category** `string`: No description
- **nextPageToken** `string`: No description
- **totalMediaItemsCount** `integer`: No description
#### 400: Invalid request
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
## POST /v1/accounts/{accountId}/gmb-media
**Upload a photo to Google Business Profile**
Creates a media item (photo) for a location from a publicly accessible URL.
Categories determine where the photo appears:
- `COVER` - Cover photo
- `PROFILE` - Profile photo
- `LOGO` - Business logo
- `EXTERIOR` - Exterior shots
- `INTERIOR` - Interior shots
- `FOOD_AND_DRINK` - Food and drink photos
- `MENU` - Menu photos
- `PRODUCT` - Product photos
- `TEAMS` - Team/staff photos
- `ADDITIONAL` - Other photos
### Parameters
- **accountId** (required) in path: No description
### Request Body
- **sourceUrl** (required) `string`: Publicly accessible image URL
- **mediaFormat** `string`: No description - one of: PHOTO, VIDEO
- **description** `string`: Photo description
- **category** `string`: Where the photo appears on the listing - one of: COVER, PROFILE, LOGO, EXTERIOR, INTERIOR, FOOD_AND_DRINK, MENU, PRODUCT, TEAMS, ADDITIONAL
### Responses
#### 200: Media created successfully
**Response Body:**
- **success** `boolean`: No description
- **name** `string`: No description
- **mediaFormat** `string`: No description
- **googleUrl** `string`: No description
#### 400: Invalid request or unsupported media format
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
## DELETE /v1/accounts/{accountId}/gmb-media
**Delete a photo from Google Business Profile**
### Parameters
- **accountId** (required) in path: No description
- **mediaId** (required) in query: The media item ID to delete
### Responses
#### 200: Media deleted successfully
**Response Body:**
- **success** `boolean`: No description
- **deleted** `boolean`: No description
- **mediaId** `string`: No description
#### 400: Invalid request
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
# Related Schema Definitions
## ErrorResponse
### Properties
- **error** `string`: No description
- **details** `object`: No description
---
# GMB Place Actions API Reference
Create and manage booking, ordering, and reservation action links for Google Business Profile locations via the Late API
## GET /v1/accounts/{accountId}/gmb-place-actions
**List place action links (booking, ordering, reservations)**
Lists place action links for a Google Business Profile location.
Place actions are the booking, ordering, and reservation buttons that appear on your listing.
### Parameters
- **accountId** (required) in path: No description
- **pageSize** (optional) in query: No description
- **pageToken** (optional) in query: No description
### Responses
#### 200: Place actions fetched successfully
**Response Body:**
- **success** `boolean`: No description
- **accountId** `string`: No description
- **locationId** `string`: No description
- **placeActionLinks** `array[object]`:
- **name** `string`: Resource name
- **uri** `string`: Action URL
- **placeActionType** `string`: No description
- **createTime** `string` (date-time): No description
- **updateTime** `string` (date-time): No description
- **nextPageToken** `string`: No description
#### 400: Invalid request
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
## POST /v1/accounts/{accountId}/gmb-place-actions
**Create a place action link (booking, ordering, reservation)**
Creates a place action link for a location.
Available action types:
- `APPOINTMENT` - Booking an appointment
- `ONLINE_APPOINTMENT` - Booking an online appointment
- `DINING_RESERVATION` - Making a dining reservation (OpenTable, Resy, etc.)
- `FOOD_ORDERING` - Ordering food for delivery and/or takeout (DoorDash, Uber Eats, etc.)
- `FOOD_DELIVERY` - Ordering food for delivery only
- `FOOD_TAKEOUT` - Ordering food for takeout only
- `SHOP_ONLINE` - Shopping with delivery and/or pickup
### Parameters
- **accountId** (required) in path: No description
### Request Body
- **uri** (required) `string`: The action URL
- **placeActionType** (required) `string`: Type of action - one of: APPOINTMENT, ONLINE_APPOINTMENT, DINING_RESERVATION, FOOD_ORDERING, FOOD_DELIVERY, FOOD_TAKEOUT, SHOP_ONLINE
### Responses
#### 200: Place action created successfully
**Response Body:**
- **success** `boolean`: No description
- **name** `string`: Resource name of the created link
- **uri** `string`: No description
- **placeActionType** `string`: No description
#### 400: Invalid request
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
## DELETE /v1/accounts/{accountId}/gmb-place-actions
**Delete a place action link**
### Parameters
- **accountId** (required) in path: No description
- **name** (required) in query: The resource name of the place action link (e.g. locations/123/placeActionLinks/456)
### Responses
#### 200: Place action deleted successfully
**Response Body:**
- **success** `boolean`: No description
- **deleted** `boolean`: No description
- **name** `string`: No description
#### 400: Invalid request
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
# Related Schema Definitions
## ErrorResponse
### Properties
- **error** `string`: No description
- **details** `object`: No description
---
# GMB Reviews API Reference
Retrieve and manage Google My Business reviews and ratings via the Late API
## GET /v1/accounts/{accountId}/gmb-reviews
**Get Google Business Profile reviews**
Fetches reviews for a connected Google Business Profile account.
Returns all reviews for the business location, including:
- Reviewer information (name, profile photo)
- Star rating (1-5)
- Review comment/text
- Business owner's reply (if any)
- Review timestamps
Use pagination via `nextPageToken` to fetch all reviews for locations with many reviews.
### Parameters
- **accountId** (required) in path: The Late account ID (from /v1/accounts)
- **pageSize** (optional) in query: Number of reviews to fetch per page (max 50)
- **pageToken** (optional) in query: Pagination token from previous response
### Responses
#### 200: Reviews fetched successfully
**Response Body:**
- **success** `boolean`: No description
- **accountId** `string`: No description
- **locationId** `string`: No description
- **reviews** `array[object]`:
- **id** `string`: Review ID
- **name** `string`: Full resource name
- **reviewer** `object`:
- **displayName** `string`: No description
- **profilePhotoUrl** `string`: No description
- **isAnonymous** `boolean`: No description
- **rating** `integer`: Numeric star rating
- **starRating** `string`: Google's string rating - one of: ONE, TWO, THREE, FOUR, FIVE
- **comment** `string`: Review text
- **createTime** `string` (date-time): No description
- **updateTime** `string` (date-time): No description
- **reviewReply** `object`:
- **comment** `string`: Business owner reply
- **updateTime** `string` (date-time): No description
- **averageRating** `number`: Overall average rating
- **totalReviewCount** `integer`: Total number of reviews
- **nextPageToken** `string`: Token for next page
#### 400: Invalid request - not a Google Business account or missing location
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 401: Unauthorized or token expired
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 403: Permission denied for this location
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
#### 500: Failed to fetch reviews
**Response Body:**
- **error** `string`: No description
- **details** `object`: No description
---
# Related Schema Definitions
## ErrorResponse
### Properties
- **error** `string`: No description
- **details** `object`: No description
---
# LinkedIn Mentions API Reference
Monitor and track LinkedIn mentions, tags, and engagement metrics via Late
## GET /v1/accounts/{accountId}/linkedin-mentions
**Resolve a LinkedIn profile or company URL to a URN for @mentions**
Converts a LinkedIn profile URL (person) or company page URL (organization) to a URN that can be used to @mention them in posts.
**Supports both:**
- **Person mentions:** `linkedin.com/in/username` or just `username`
- **Organization mentions:** `linkedin.com/company/company-name` or `company/company-name`
**⚠️ Organization Admin Required for Person Mentions Only:**
Person mentions require the connected LinkedIn account to have admin access to at least one LinkedIn Organization (Company Page).
Organization mentions do NOT have this requirement - any LinkedIn account can tag companies.
**IMPORTANT - Display Name Requirement:**
For **person mentions** to be clickable, the display name must **exactly match** what appears on their LinkedIn profile.
- Organization mentions automatically retrieve the company name from LinkedIn API
- Person mentions require the exact name, so provide the `displayName` parameter
**Mention Format:**
Use the returned `mentionFormat` value directly in your post content:
```
Great insights from @[Miquel Palet](urn:li:person:4qj5ox-agD) on this topic!
Excited to partner with @[Microsoft](urn:li:organization:1035)!
```
### Parameters
- **accountId** (required) in path: The LinkedIn account ID
- **url** (required) in query: LinkedIn profile URL, company URL, or vanity name.
- Person: `miquelpalet`, `linkedin.com/in/miquelpalet`
- Organization: `company/microsoft`, `linkedin.com/company/microsoft`
- **displayName** (optional) in query: The exact display name as shown on LinkedIn.
- **Person mentions:** Required for clickable mentions. If not provided, a name is derived from the vanity URL which may not match exactly.
- **Organization mentions:** Optional. If not provided, the company name is automatically retrieved from LinkedIn.
### Responses
#### 200: URN resolved successfully
**Response Body:**
- **urn** `string`: The LinkedIn URN (person or organization) (example: "urn:li:person:4qj5ox-agD")
- **type** `string`: The type of entity (person or organization) - one of: person, organization (example: "person")
- **displayName** `string`: Display name (provided, from API, or derived from vanity URL) (example: "Miquel Palet")
- **mentionFormat** `string`: Ready-to-use mention format for post content (example: "@[Miquel Palet](urn:li:person:4qj5ox-agD)")
- **vanityName** `string`: The vanity name/slug (only for organization mentions) (example: "microsoft")
- **warning** `string`: Warning about clickable mentions (only present for person mentions if displayName was not provided) (example: "For clickable person mentions, provide the displayName parameter with the exact name as shown on their LinkedIn profile.")
#### 400: Invalid request or no organization found (for person mentions)
**Response Body:**
- **error** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Person or organization not found
**Response Body:**
- **error** `string`: No description
---
---
# Media API Reference
Upload and manage media files including images, videos, and documents for posts
## POST /v1/media/presign
**Get a presigned URL for direct file upload (up to 5GB)**
Get a presigned URL to upload files directly to cloud storage. This is the recommended method for uploading files of any size, especially files larger than ~4MB.
**How it works:**
1. Call this endpoint with the filename and content type
2. Receive an `uploadUrl` (presigned) and `publicUrl`
3. PUT your file directly to the `uploadUrl`
4. Use the `publicUrl` in your posts
**Benefits:**
- Supports files up to 5GB
- Files upload directly to storage (faster, no server bottleneck)
- No 413 errors from server body size limits
**Example:**
```javascript
// Step 1: Get presigned URL
const response = await fetch('https://getlate.dev/api/v1/media/presign', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
filename: 'my-video.mp4',
contentType: 'video/mp4'
})
});
const { uploadUrl, publicUrl } = await response.json();
// Step 2: Upload file directly to storage
await fetch(uploadUrl, {
method: 'PUT',
body: file,
headers: { 'Content-Type': 'video/mp4' }
});
// Step 3: Use publicUrl when creating your post
// The publicUrl is ready to use immediately after upload completes
```
### Request Body
- **filename** (required) `string`: Name of the file to upload
- **contentType** (required) `string`: MIME type of the file - one of: image/jpeg, image/jpg, image/png, image/webp, image/gif, video/mp4, video/mpeg, video/quicktime, video/avi, video/x-msvideo, video/webm, video/x-m4v, application/pdf
- **size** `integer`: Optional file size in bytes for pre-validation (max 5GB)
### Responses
#### 200: Presigned URL generated successfully
**Response Body:**
- **uploadUrl** `string` (uri): Presigned URL to PUT your file to (expires in 1 hour)
- **publicUrl** `string` (uri): Public URL where the file will be accessible after upload
- **key** `string`: Storage key/path of the file
- **type** `string`: Detected file type based on content type - one of: image, video, document
#### 400: Invalid request (missing filename, contentType, or unsupported content type)
**Response Body:**
- **error** `string`: No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
---
# Queue API Reference
Configure posting schedules, time slots, and queue management for automated posting
## GET /v1/queue/slots
**Get queue schedules for a profile**
Retrieve queue schedules for a profile. Each profile can have multiple queues.
- Without `all=true`: Returns the default queue (or specific queue if queueId provided)
- With `all=true`: Returns all queues for the profile
### Parameters
- **profileId** (required) in query: Profile ID to get queues for
- **queueId** (optional) in query: Specific queue ID to retrieve (optional)
- **all** (optional) in query: Set to 'true' to list all queues for the profile
### Responses
#### 200: Queue schedule(s) retrieved
**Response Body:**
*One of the following:*
- **exists** `boolean`: No description
- **schedule**: `QueueSchedule` - See schema definition
- **nextSlots** `array[string]`:
- **queues** `array[QueueSchedule]`:
- **count** `integer`: No description
#### 400: Missing profileId
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Profile not found
---
## POST /v1/queue/slots
**Create a new queue for a profile**
Create an additional queue for a profile. The first queue created becomes the default.
Subsequent queues are non-default unless explicitly set.
### Request Body
- **profileId** (required) `string`: Profile ID
- **name** (required) `string`: Queue name (e.g., Evening Posts)
- **timezone** (required) `string`: IANA timezone
- **slots** (required) `array`: No description
- **active** `boolean`: No description
### Responses
#### 201: Queue created
**Response Body:**
- **success** `boolean`: No description
- **schedule**: `QueueSchedule` - See schema definition
- **nextSlots** `array[string]`:
#### 400: Invalid request or validation error
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Profile not found
---
## PUT /v1/queue/slots
**Create or update a queue schedule**
Create a new queue or update an existing one.
- Without queueId: Creates or updates the default queue
- With queueId: Updates the specific queue
- With setAsDefault=true: Makes this queue the default for the profile
### Request Body
- **profileId** (required) `string`: No description
- **queueId** `string`: Queue ID to update (optional)
- **name** `string`: Queue name
- **timezone** (required) `string`: No description
- **slots** (required) `array`: No description
- **active** `boolean`: No description
- **setAsDefault** `boolean`: Make this queue the default
- **reshuffleExisting** `boolean`: Whether to reschedule existing queued posts to match new slots
### Responses
#### 200: Queue schedule updated
**Response Body:**
- **success** `boolean`: No description
- **schedule**: `QueueSchedule` - See schema definition
- **nextSlots** `array[string]`:
- **reshuffledCount** `integer`: No description
#### 400: Invalid request
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Profile not found
---
## DELETE /v1/queue/slots
**Delete a queue schedule**
Delete a queue from a profile. Requires queueId to specify which queue to delete.
If deleting the default queue, another queue will be promoted to default.
### Parameters
- **profileId** (required) in query: No description
- **queueId** (required) in query: Queue ID to delete
### Responses
#### 200: Queue schedule deleted
**Response Body:**
- **success** `boolean`: No description
- **deleted** `boolean`: No description
#### 400: Missing profileId or queueId
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
---
## GET /v1/queue/preview
**Preview upcoming queue slots for a profile**
### Parameters
- **profileId** (required) in query: No description
- **count** (optional) in query: No description
### Responses
#### 200: Queue slots preview
**Response Body:**
- **profileId** `string`: No description
- **count** `integer`: No description
- **slots** `array[string]`:
#### 400: Invalid parameters
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Profile or queue schedule not found
---
## GET /v1/queue/next-slot
**Preview the next available queue slot (informational only)**
Returns the next available queue slot for preview/informational purposes.
**Important: To schedule a post to the queue, do NOT use this endpoint's response
with `scheduledFor`.** That creates a manual post, not a queue post.
Instead, use `POST /v1/posts` with `queuedFromProfile` (and optionally `queueId`).
The system will automatically assign the next available slot with proper locking
to prevent race conditions.
This endpoint is useful for:
- Showing users when their next post will go out before they commit
- Debugging/verifying queue configuration
- Building UI previews
If no queueId is specified, uses the profile's default queue.
### Parameters
- **profileId** (required) in query: No description
- **queueId** (optional) in query: Specific queue ID (optional, defaults to profile's default queue)
### Responses
#### 200: Next available slot
**Response Body:**
- **profileId** `string`: No description
- **nextSlot** `string` (date-time): No description
- **timezone** `string`: No description
- **queueId** `string`: Queue ID this slot belongs to
- **queueName** `string`: Queue name
#### 400: Invalid parameters or inactive queue
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Profile or queue schedule not found, or no available slots
---
# Related Schema Definitions
## QueueSchedule
### Properties
- **_id** `string`: Unique queue identifier
- **profileId** `string`: Profile ID this queue belongs to
- **name** `string`: Queue name (e.g., "Morning Posts", "Evening Content")
- **timezone** `string`: IANA timezone (e.g., America/New_York)
- **slots** `array`: No description
- **active** `boolean`: Whether the queue is active
- **isDefault** `boolean`: Whether this is the default queue for the profile (used when no queueId specified)
- **createdAt** `string`: No description
- **updatedAt** `string`: No description
---
# Reddit Search API Reference
Search Reddit posts and comments across subreddits for content discovery via Late
## GET /v1/reddit/search
**Search Reddit posts via a connected account**
### Parameters
- **accountId** (required) in query: No description
- **subreddit** (optional) in query: No description
- **q** (required) in query: No description
- **restrict_sr** (optional) in query: No description
- **sort** (optional) in query: No description
- **limit** (optional) in query: No description
- **after** (optional) in query: No description
### Responses
#### 200: Search results
**Response Body:**
- **posts** `array[object]`:
- **id** `string`: No description
- **title** `string`: No description
- **selftext** `string`: No description
- **author** `string`: No description
- **subreddit** `string`: No description
- **score** `integer`: No description
- **num_comments** `integer`: No description
- **created_utc** `number`: No description
- **permalink** `string`: No description
- **after** `string`: No description
#### 400: Missing params
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Account not found
---
## GET /v1/reddit/feed
**Fetch subreddit feed via a connected account**
### Parameters
- **accountId** (required) in query: No description
- **subreddit** (optional) in query: No description
- **sort** (optional) in query: No description
- **limit** (optional) in query: No description
- **after** (optional) in query: No description
- **t** (optional) in query: No description
### Responses
#### 200: Feed items
**Response Body:**
- **posts** `array[object]`:
Type: `object`
- **after** `string`: No description
#### 400: Missing params
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Account not found
---
---
# Usage API Reference
Track API usage statistics, rate limits, and quota consumption for your account
## GET /v1/usage-stats
**Get plan and usage stats for current account**
### Responses
#### 200: Usage stats
**Response Body:**
- **planName** `string`: No description
- **billingPeriod** `string`: No description - one of: monthly, yearly
- **signupDate** `string` (date-time): No description
- **limits** `object`:
- **uploads** `integer`: No description
- **profiles** `integer`: No description
- **usage** `object`:
- **uploads** `integer`: No description
- **profiles** `integer`: No description
- **lastReset** `string` (date-time): No description
#### 401: Unauthorized
**Response Body:**
- **error** `string`: No description (example: "Unauthorized")
#### 404: Resource not found
**Response Body:**
- **error** `string`: No description (example: "Not found")
---
# Related Schema Definitions
## UsageStats
### Properties
- **planName** `string`: No description
- **billingPeriod** `string`: No description - one of: monthly, yearly
- **signupDate** `string`: No description
- **limits** `object`:
- **uploads** `integer`:
- **profiles** `integer`:
- **usage** `object`:
- **uploads** `integer`:
- **profiles** `integer`:
- **lastReset** `string`:
---
# Migrate from Ayrshare
Step-by-step guide to migrate from Ayrshare to Late API
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
import { Callout } from 'fumadocs-ui/components/callout';
import { Step, Steps } from 'fumadocs-ui/components/steps';
This guide walks you through migrating from Ayrshare to Late. Choose the path that fits your situation:
| Path | Best for | Effort |
|------|----------|--------|
| **[Drop-in SDK](#drop-in-sdk-replacement)** | Already using the Ayrshare `social-media-api` npm package | ~5 minutes |
| **[Full API migration](#quick-reference)** | Using raw HTTP calls or a custom client | 1–2 hours |
---
## Drop-in SDK Replacement
If you're using the Ayrshare `social-media-api` npm package, the fastest way to migrate is our **drop-in replacement SDK**. All method signatures are identical — just swap the package and API key.
### Install
```bash
npm uninstall social-media-api
npm install @getlatedev/social-media-api
```
### Update your import
```diff
- import SocialMediaAPI from 'social-media-api';
+ import SocialMediaAPI from '@getlatedev/social-media-api';
const social = new SocialMediaAPI('your_late_api_key');
```
That's it. All existing calls (`post`, `history`, `upload`, `createProfile`, etc.) work without changes.
### Supported methods
All core Ayrshare SDK methods are fully supported:
| Category | Methods |
|----------|---------|
| Posts | `post`, `delete`, `getPost`, `retryPost`, `updatePost` |
| History | `history` |
| User | `user` |
| Profiles | `createProfile`, `deleteProfile`, `updateProfile`, `getProfiles` |
| Media | `upload`, `media`, `mediaUploadUrl`, `verifyMediaExists` |
| Analytics | `analyticsPost`, `analyticsSocial` |
| Comments | `postComment`, `getComments`, `deleteComments`, `replyComment` |
| Webhooks | `registerWebhook`, `unregisterWebhook`, `listWebhooks` |
| Scheduling | `setAutoSchedule`, `deleteAutoSchedule`, `listAutoSchedule` |
| Reviews | `reviews`, `review`, `replyReview`, `deleteReplyReview` |
**Not yet available:** AI generation (`generatePost`, `generateRewrite`, etc.), RSS feeds, URL shortening, and a few media/analytics utilities return `501` for now. See the [full compatibility list](https://github.com/getlate-dev/social-media-api#not-yet-available) for details.
### Multi-profile support
If you use Ayrshare Profile Keys, the SDK supports the same pattern:
```typescript
social.setProfileKey('your_profile_key');
// All subsequent requests are scoped to this profile
const history = await social.history({ lastRecords: 10 });
```
Find your profile keys via `social.getProfiles()`.
**Source code & issues:** [github.com/getlate-dev/social-media-api](https://github.com/getlate-dev/social-media-api)
---
## Full API Migration
If you're making raw HTTP calls or want to use Late's native API directly, follow the steps below.
## Quick Reference
The main differences at a glance:
| What | Ayrshare | Late |
|------|----------|------|
| Base URL | `api.ayrshare.com/api` | `getlate.dev/api/v1` |
| Content field | `post` | `content` |
| Platforms | `["twitter", "facebook"]` | `[{platform, accountId}]` |
| Media | `mediaUrls: ["url"]` | `mediaItems: [{type, url}]` |
| Schedule | `scheduleDate` | `scheduledFor` |
| Publish now | Omit `scheduleDate` | `publishNow: true` |
| Multi-user | `Profile-Key` header | Profiles as resources |
---
## Before You Start
**What you'll need:**
- Your Ayrshare API key and Profile Keys
- A Late account ([sign up here](https://getlate.dev))
- A Late API key from your dashboard
### How Late organizes accounts
Late uses a two-level structure:
```
Profile: "Acme Corp"
├── Twitter (@acmecorp)
├── LinkedIn (Acme Corp Page)
└── Facebook (Acme Corp)
Profile: "Side Project"
├── Twitter (@sideproject)
└── Instagram (@sideproject)
```
**Profiles** group social accounts together (like brands or clients). Each **Account** is a connected social media account with its own `accountId`.
---
## Step 1: Set Up Late Profiles
For each Ayrshare Profile Key, create a corresponding Late profile:
```bash
curl -X POST https://getlate.dev/api/v1/profiles \
-H "Authorization: Bearer YOUR_LATE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "My Brand"}'
```
Save the returned `_id` — you'll need it to connect accounts.
---
## Step 2: Connect Social Accounts
Initiate OAuth for each platform you had connected in Ayrshare:
```bash
curl -X GET "https://getlate.dev/api/v1/connect/{platform}?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback" \
-H "Authorization: Bearer YOUR_LATE_API_KEY"
```
**Supported platforms:** `twitter` `instagram` `facebook` `linkedin` `tiktok` `youtube` `pinterest` `reddit` `bluesky` `threads` `googlebusiness` `telegram` `snapchat`
**Platform name change:** Ayrshare uses `gmb` for Google My Business. Late uses `googlebusiness` (no underscore).
The response includes an `authUrl` — redirect your user there to complete authorization.
---
## Step 3: Get Your Account IDs
After connecting, fetch the account IDs:
```bash
curl -X GET "https://getlate.dev/api/v1/accounts?profileId=PROFILE_ID" \
-H "Authorization: Bearer YOUR_LATE_API_KEY"
```
```json
{
"accounts": [
{
"_id": "abc123",
"platform": "twitter",
"username": "@yourhandle",
"displayName": "Your Name"
}
]
}
```
**Store this mapping** in your database — you'll need the `_id` values when creating posts.
---
## Step 4: Update Your Post Calls
Here's how the API calls change:
**Ayrshare:**
```bash
curl -X POST https://api.ayrshare.com/api/post \
-H "Authorization: Bearer API_KEY" \
-H "Profile-Key: PROFILE_KEY" \
-d '{
"post": "Hello world!",
"platforms": ["twitter", "linkedin"]
}'
```
**Late:**
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-H "Authorization: Bearer API_KEY" \
-d '{
"content": "Hello world!",
"platforms": [
{"platform": "twitter", "accountId": "abc123"},
{"platform": "linkedin", "accountId": "def456"}
],
"publishNow": true
}'
```
**Ayrshare:**
```bash
curl -X POST https://api.ayrshare.com/api/post \
-d '{
"post": "See you tomorrow!",
"platforms": ["twitter"],
"scheduleDate": "2025-01-15T10:00:00Z"
}'
```
**Late:**
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-d '{
"content": "See you tomorrow!",
"platforms": [
{"platform": "twitter", "accountId": "abc123"}
],
"scheduledFor": "2025-01-15T10:00:00Z"
}'
```
Omit `publishNow` for scheduled posts — it defaults to `false`.
**Ayrshare:**
```bash
curl -X POST https://api.ayrshare.com/api/post \
-d '{
"post": "Check this out!",
"platforms": ["twitter"],
"mediaUrls": ["https://example.com/image.jpg"]
}'
```
**Late:**
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-d '{
"content": "Check this out!",
"platforms": [
{"platform": "twitter", "accountId": "abc123"}
],
"mediaItems": [
{"type": "image", "url": "https://example.com/image.jpg"}
],
"publishNow": true
}'
```
### Key changes summary
| Ayrshare | Late |
|----------|------|
| `post` | `content` |
| `platforms: ["twitter"]` | `platforms: [{platform: "twitter", accountId: "..."}]` |
| `mediaUrls: ["url"]` | `mediaItems: [{type: "image", url: "..."}]` |
| `scheduleDate` | `scheduledFor` |
| Omit scheduleDate to publish | `publishNow: true` |
| `Profile-Key` header | Not needed (use `accountId` in platforms) |
---
## Step 5: Update Media Uploads
Late uses presigned URLs for uploads (supports files up to 5GB):
### Request a presigned URL
```bash
curl -X POST https://getlate.dev/api/v1/media/presign \
-H "Authorization: Bearer API_KEY" \
-d '{"filename": "photo.jpg", "contentType": "image/jpeg"}'
```
Response:
```json
{
"uploadUrl": "https://storage.../presigned-url",
"publicUrl": "https://media.getlate.dev/temp/photo.jpg"
}
```
### Upload your file
```bash
curl -X PUT "https://storage.../presigned-url" \
-H "Content-Type: image/jpeg" \
--data-binary "@photo.jpg"
```
### Use the public URL in your post
```json
{
"mediaItems": [
{"type": "image", "url": "https://media.getlate.dev/temp/photo.jpg"}
]
}
```
**Already have public URLs?** Skip the upload — just pass your URLs directly in `mediaItems`.
**Supported types:** `image/jpeg` `image/png` `image/webp` `image/gif` `video/mp4` `video/quicktime` `video/webm` `application/pdf`
---
## Step 6: Migrate Scheduled Posts
Don't lose your queued content! Export scheduled posts from Ayrshare and recreate them in Late.
**Export from Ayrshare:**
```bash
curl -X GET https://api.ayrshare.com/api/history \
-H "Authorization: Bearer AYRSHARE_KEY" \
-H "Profile-Key: PROFILE_KEY"
```
**Recreate in Late** for each post with a future `scheduleDate`:
```bash
curl -X POST https://getlate.dev/api/v1/posts \
-d '{
"content": "...",
"platforms": [{"platform": "twitter", "accountId": "..."}],
"scheduledFor": "2025-01-20T14:00:00Z"
}'
```
Then delete or pause the Ayrshare posts to avoid duplicates.
---
## Cutover Strategy
**Don't switch all at once.** Use a gradual rollout to catch issues early.
| Phase | Actions |
|-------|---------|
| **Prep** | Create Late profiles, connect accounts, build integration |
| **Pilot** | Test with internal users for a few days |
| **Rollout** | Enable for 10% → 50% → 100% of users |
| **Cutoff** | Disable Ayrshare, keep keys for 30 days as fallback |
---
## Troubleshooting
| Error | Cause | Fix |
|-------|-------|-----|
| Invalid accountId | Using Ayrshare profile key | Use Late account `_id` from `/v1/accounts` |
| Platform not supported | Wrong platform name | Use `googlebusiness` not `gmb` |
| Media not found | URL inaccessible | Ensure HTTPS and publicly accessible |
| Post not publishing | Wrong date format | Use ISO 8601 UTC: `2025-01-15T10:00:00Z` |
---
## Code Example: Node.js
```javascript
// Late post function
const createPost = async (content, accounts, media = [], scheduledFor = null) => {
const response = await fetch('https://getlate.dev/api/v1/posts', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.LATE_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
content,
platforms: accounts, // [{platform: "twitter", accountId: "..."}]
mediaItems: media.map(url => ({
type: url.match(/\.(mp4|mov|webm)$/i) ? 'video' : 'image',
url
})),
...(scheduledFor ? { scheduledFor } : { publishNow: true })
}),
});
const data = await response.json();
return data.post._id;
};
```
---
## Need Help?
- **Late API Docs:** [docs.getlate.dev](https://docs.getlate.dev)
- **Support:** miki@getlate.dev
- **Rate Limits:** 60-1200 req/min depending on plan
---