Animated GIFs are a fun, engaging way to capture attention. Use the Publer API to create or schedule single‐GIF posts with caption and thumbnail support across multiple platforms.
GIF posts let you share looping animations with optional captions and metadata. Perfect for reactions, announcements, or adding personality to your feed.
Cross-Platform GIF Publishing
Custom Caption Support
Thumbnail Preview
Immediate or Scheduled Posting
Send to the scheduling endpoint (/posts/schedule) or immediate‐publish (/posts/schedule/publish):
Reference or upload your GIF via the .
Build your post object with "type": "gif".
(Optional) Add "thumbnail" and "name" for preview.
Compress GIFs to meet platform size limits without sacrificing quality.
Provide a clear, engaging thumbnail to boost click-through.
Use concise captions to add context or calls-to-action.
Mastodon
8 MB
Supports JPEG, PNG, WEBP, and GIF
Unlimited
—
networks.{provider}.media[].thumbnail
URL to a GIF thumbnail (e.g., WebP format)
networks.{provider}.media[].name
Descriptive name or title for the GIF
accounts[].id
Target social media account ID
accounts[].scheduled_at
ISO 8601 timestamp for scheduling (omit for immediate)
/posts/schedule or /posts/schedule/publish.Monitor /api/v1/job_status/{job_id} for completion.
4 MB
—
Twitter/X
15 MB
4×4 to 2048×2048 px resolution
Unlimited
Native GIF support
Telegram
50 MB
—
networks.{provider}.type
Must be "gif".
networks.{provider}.media
Array of exactly one media object
networks.{provider}.media[].id
"external" or your uploaded media ID
networks.{provider}.media[].type
Must be "gif".
networks.{provider}.media[].url
Direct URL to the GIF file
networks.{provider}.media[].path
Same as URL or CDN path
POST /api/v1/posts/schedule
{
"bulk": {
"state": "scheduled",
"posts": [
{
"networks": {
"facebook": {
"type": "gif",
"text": "Check out this fun GIF!",
"media": [
{
"id": "external",
"type": "gif",
"url": "https://media.giphy.com/media/xyz/giphy.gif",
"path": "https://media.giphy.com/media/xyz/giphy.gif",
"thumbnail": "https://media.giphy.com/media/xyz/200w.webp",
"name": "Fun Reaction GIF"
}
]
}
},
"accounts": [
{
"id": "ACCOUNT_ID",
"scheduled_at": "2025-08-02T23:18:00+02:00"
}
]
}
]
}
}