Quick Start

Post to Facebook in under 60 seconds:

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

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);

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

Multi-Image Posts

Facebook supports up to 10 images in a single post:

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

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
  })
});

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:

{
  "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:

{
  "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:

curl -X GET https://getlate.dev/api/v1/accounts/YOUR_ACCOUNT_ID/facebook-page \
  -H "Authorization: Bearer YOUR_API_KEY"

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);

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:

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

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
  })
});

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:

{
  "platforms": [
    {
      "platform": "facebook",
      "accountId": "acc_123",
      "platformSpecificData": {
        "pageId": "123456789"
      }
    }
  ]
}