Create Slideshow Post

curl -X POST https://api.infinipost.co/v1/posts/slideshow \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountIds": ["acc_123", "acc_456"],
    "contentUrls": [
      "https://example.com/slide1.jpg",
      "https://example.com/slide2.jpg",
      "https://example.com/slide3.jpg"
    ],
    "caption": "Swipe for more! 👉",
    "soundId": "sound_abc123",
    "markAI": false,
    "slideDuration": 6,
    "renderAsVideo": false,
    "scheduledTime": "2024-04-22T14:00",
    "timezone": "America/New_York"
  }'

const response = await fetch('https://api.infinipost.co/v1/posts/slideshow', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    accountIds: ['acc_123', 'acc_456'],
    contentUrls: [
      'https://example.com/slide1.jpg',
      'https://example.com/slide2.jpg',
      'https://example.com/slide3.jpg'
    ],
    caption: 'Swipe for more! 👉',
    soundId: 'sound_abc123',
    markAI: false,
    slideDuration: 6,
    renderAsVideo: false,
    scheduledTime: '2024-04-22T14:00',
    timezone: 'America/New_York'
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://api.infinipost.co/v1/posts/slideshow',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'accountIds': ['acc_123', 'acc_456'],
        'contentUrls': [
            'https://example.com/slide1.jpg',
            'https://example.com/slide2.jpg',
            'https://example.com/slide3.jpg'
        ],
        'caption': 'Swipe for more! 👉',
        'soundId': 'sound_abc123',
        'markAI': False,
        'slideDuration': 6,
        'renderAsVideo': False,
        'scheduledTime': '2024-04-22T14:00',
        'timezone': 'America/New_York'
    }
)

print(response.json())

{
  "posts": [
    {
      "postId": "post_abc123",
      "accountId": "acc_123",
      "platform": "tiktok",
      "status": "scheduled",
      "scheduledTime": "2024-04-22T14:00",
    "timezone": "America/New_York",
      "renderAsVideo": false,
      "createdAt": "2024-04-21T20:15:00Z"
    },
    {
      "postId": "post_def456",
      "accountId": "acc_456",
      "platform": "instagram",
      "status": "scheduled",
      "scheduledTime": "2024-04-22T14:00",
    "timezone": "America/New_York",
      "renderAsVideo": false,
      "createdAt": "2024-04-21T20:15:00Z"
    }
  ]
}

POST

posts

slideshow

curl -X POST https://api.infinipost.co/v1/posts/slideshow \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountIds": ["acc_123", "acc_456"],
    "contentUrls": [
      "https://example.com/slide1.jpg",
      "https://example.com/slide2.jpg",
      "https://example.com/slide3.jpg"
    ],
    "caption": "Swipe for more! 👉",
    "soundId": "sound_abc123",
    "markAI": false,
    "slideDuration": 6,
    "renderAsVideo": false,
    "scheduledTime": "2024-04-22T14:00",
    "timezone": "America/New_York"
  }'

const response = await fetch('https://api.infinipost.co/v1/posts/slideshow', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    accountIds: ['acc_123', 'acc_456'],
    contentUrls: [
      'https://example.com/slide1.jpg',
      'https://example.com/slide2.jpg',
      'https://example.com/slide3.jpg'
    ],
    caption: 'Swipe for more! 👉',
    soundId: 'sound_abc123',
    markAI: false,
    slideDuration: 6,
    renderAsVideo: false,
    scheduledTime: '2024-04-22T14:00',
    timezone: 'America/New_York'
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://api.infinipost.co/v1/posts/slideshow',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'accountIds': ['acc_123', 'acc_456'],
        'contentUrls': [
            'https://example.com/slide1.jpg',
            'https://example.com/slide2.jpg',
            'https://example.com/slide3.jpg'
        ],
        'caption': 'Swipe for more! 👉',
        'soundId': 'sound_abc123',
        'markAI': False,
        'slideDuration': 6,
        'renderAsVideo': False,
        'scheduledTime': '2024-04-22T14:00',
        'timezone': 'America/New_York'
    }
)

print(response.json())

{
  "posts": [
    {
      "postId": "post_abc123",
      "accountId": "acc_123",
      "platform": "tiktok",
      "status": "scheduled",
      "scheduledTime": "2024-04-22T14:00",
    "timezone": "America/New_York",
      "renderAsVideo": false,
      "createdAt": "2024-04-21T20:15:00Z"
    },
    {
      "postId": "post_def456",
      "accountId": "acc_456",
      "platform": "instagram",
      "status": "scheduled",
      "scheduledTime": "2024-04-22T14:00",
    "timezone": "America/New_York",
      "renderAsVideo": false,
      "createdAt": "2024-04-21T20:15:00Z"
    }
  ]
}

Request Body

array

required

Array of account IDs to post to (e.g., ["acc_123", "acc_456"]).

array

required

Array of image URLs for the slideshow (e.g., ["https://example.com/slide1.jpg", "https://example.com/slide2.jpg"]).

string

Post caption/description.

string

ID of a TikTok sound to attach to the post.Platform Support:

TikTok: Supported
Instagram: Not supported

See Upload Sound for how to import sounds from TikTok.

boolean

default:"false"

When true, adds an AI-generated content label to the post.

string

Local time to post, in YYYY-MM-DDTHH:MM format (e.g. "2024-04-22T14:00"). If not provided, posts immediately.Interpreted in the timezone specified by the timezone parameter.

string

default:"America/New_York"

IANA timezone for interpreting scheduledTime. Supported values:

Value	Label
`America/New_York`	Eastern (ET)
`America/Chicago`	Central (CT)
`America/Denver`	Mountain (MT)
`America/Los_Angeles`	Pacific (PT)
`America/Anchorage`	Alaska (AKT)
`Pacific/Honolulu`	Hawaii (HST)
`Europe/London`	London (GMT)
`Europe/Paris`	Paris (CET)
`Asia/Tokyo`	Tokyo (JST)
`Asia/Singapore`	Singapore (SGT)
`Australia/Sydney`	Sydney (AEDT)

number

default:"4"

Duration per slide in seconds. Options: 4, 6, or 8. Only applies when renderAsVideo is true.

boolean

default:"false"

When true, the slideshow images are rendered into a single video file (at the specified slideDuration per slide) before posting. When false (default), images are posted as a native slideshow directly on each platform.Platform behavior:

TikTok: Native slideshow posts as an image carousel. Set renderAsVideo: true to post as a video instead.
Instagram: Native slideshow posts as a Reels carousel. Set renderAsVideo: true to post as a Reel video instead.

When to use renderAsVideo: true:

You want to attach a soundId to an Instagram post (native slideshows don’t support sound on Instagram)
You need guaranteed video format for downstream analytics or repurposing

When renderAsVideo is true, posts will show a pending_render status while the video is being rendered in the background. Once rendering is complete the status moves to scheduled, at which point the post will go live at the specified scheduledTime.

Response

array

Array of created post objects (one per account).

Show properties

string

Unique identifier for the post.

string

Account ID this post belongs to.

string

Platform: tiktok or instagram.

string

Post status: scheduled, processing, posted, or failed.

string

When the post is scheduled to go live.

boolean

Whether the slideshow will be rendered to video before posting.

string

ISO 8601 timestamp of when the post was created.

curl -X POST https://api.infinipost.co/v1/posts/slideshow \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountIds": ["acc_123", "acc_456"],
    "contentUrls": [
      "https://example.com/slide1.jpg",
      "https://example.com/slide2.jpg",
      "https://example.com/slide3.jpg"
    ],
    "caption": "Swipe for more! 👉",
    "soundId": "sound_abc123",
    "markAI": false,
    "slideDuration": 6,
    "renderAsVideo": false,
    "scheduledTime": "2024-04-22T14:00",
    "timezone": "America/New_York"
  }'

const response = await fetch('https://api.infinipost.co/v1/posts/slideshow', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    accountIds: ['acc_123', 'acc_456'],
    contentUrls: [
      'https://example.com/slide1.jpg',
      'https://example.com/slide2.jpg',
      'https://example.com/slide3.jpg'
    ],
    caption: 'Swipe for more! 👉',
    soundId: 'sound_abc123',
    markAI: false,
    slideDuration: 6,
    renderAsVideo: false,
    scheduledTime: '2024-04-22T14:00',
    timezone: 'America/New_York'
  })
});

const data = await response.json();

import requests

response = requests.post(
    'https://api.infinipost.co/v1/posts/slideshow',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'accountIds': ['acc_123', 'acc_456'],
        'contentUrls': [
            'https://example.com/slide1.jpg',
            'https://example.com/slide2.jpg',
            'https://example.com/slide3.jpg'
        ],
        'caption': 'Swipe for more! 👉',
        'soundId': 'sound_abc123',
        'markAI': False,
        'slideDuration': 6,
        'renderAsVideo': False,
        'scheduledTime': '2024-04-22T14:00',
        'timezone': 'America/New_York'
    }
)

print(response.json())

{
  "posts": [
    {
      "postId": "post_abc123",
      "accountId": "acc_123",
      "platform": "tiktok",
      "status": "scheduled",
      "scheduledTime": "2024-04-22T14:00",
    "timezone": "America/New_York",
      "renderAsVideo": false,
      "createdAt": "2024-04-21T20:15:00Z"
    },
    {
      "postId": "post_def456",
      "accountId": "acc_456",
      "platform": "instagram",
      "status": "scheduled",
      "scheduledTime": "2024-04-22T14:00",
    "timezone": "America/New_York",
      "renderAsVideo": false,
      "createdAt": "2024-04-21T20:15:00Z"
    }
  ]
}

Slideshow ProcessingBy default, slideshows are posted as native image carousels on both TikTok and Instagram. Set renderAsVideo: true to render them into a video first — useful when you want to attach a sound to an Instagram post or ensure video format. Video rendering happens in the background; posts will show a pending_render status until rendering is complete, then move to scheduled.

Error Responses

Unauthorized

{
  "error": {
    "code": "unauthenticated",
    "message": "Invalid or missing API key"
  }
}

Missing Required Fields

{
  "error": {
    "code": "missing_required_fields",
    "message": "contentUrls array is required and cannot be empty"
  }
}

Invalid Slide Duration

{
  "error": {
    "code": "invalid_parameter",
    "message": "slideDuration must be 4, 6, or 8 seconds"
  }
}

Account Not Found

{
  "error": {
    "code": "not_found",
    "message": "Account(s) not found: acc_1a2b3c4d5e"
  }
}

Invalid Scheduled Time

{
  "error": {
    "code": "invalid_parameter",
    "message": "scheduledTime must be a valid ISO 8601 timestamp"
  }
}

Server Error

{
  "error": {
    "code": "internal",
    "message": "An unexpected error occurred"
  }
}

Phones

Accounts

Warmup

Posts

Media

Engagement

Partners

Request Body

Response

Error Responses

​Request Body

​Response

​Error Responses

Request Body

Response

Error Responses