Create and schedule multi‐link carousel posts on Facebook Pages. Carousels let you showcase up to 10 clickable cards—each with its own image, title, description, and call-to-action—in a single organic post.

Request Body

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "facebook": {
            "type": "carousel",
            "text": "Explore our top features!",
            "sublinks": [
              {
                "url": "https://publer.com",
                "title": "Publer Dashboard",
                "description": "Manage all your social accounts in one place.",
                "images": [
                  "https://cdn.publer.com/images/dashboard1.jpg",
                  "https://cdn.publer.com/images/dashboard2.jpg"
                ],
                "default_image": 0,
                "call_to_action": "LEARN_MORE"
              },
              {
                "url": "https://publer.com/pricing",
                "title": "Pricing Plans",
                "description": "Find the right plan for your team.",
                "images": [
                  "https://cdn.publer.com/images/pricing.jpg"
                ],
                "default_image": 0,
                "call_to_action": "SIGN_UP"
              }
            ]
          }
        },
        "accounts": [
          {
            "id": "63c675b54e299e9cf2b667ea",
            "scheduled_at": "2025-07-06T23:18:00Z"
          }
        ]
      }
    ]
  }
}

Parameters

networks.facebook

sublinks[] Object

Key Notes & Limitations

• Pages Only: Supported on Facebook Pages. Group posts will include only the first sublink.

• Max Sublinks: Up to 10 cards per carousel.

• No Cost: Carousel posts are organic (no ad spend).

• Syncing: Published carousel posts can only sync back as regular link posts (no carousel structure).

Workflow

1. Select Page Choose a Facebook Page account in the accounts array.

2. Define Sublinks Provide url, title, description, and images for each card.

3. Arrange Order Order sublinks as they should appear (array index defines order).

4. Schedule or Publish

   • For scheduled: set scheduled_at under accounts.

   • For immediate: omit scheduled_at and use /posts/schedule/publish.

Best Practices

• Engaging Thumbnails Use high-quality images that clearly represent each link.

• Clear Titles & Descriptions Keep text concise and action-oriented to drive clicks.

• Focused Carousels Limit to 5–7 cards to avoid overwhelming users.

• A/B Test CTAs Experiment with LEARN_MORE, SIGN_UP, and other button types.

Related Topics

• Platform-Specific Formats

• Publishing Methods

• Content Types

Each social network offers unique post formats. Publer’s API supports these specialized types—click a format to dive into its implementation details:

• Text Posts with Background

• Multi-Link Posts (Facebook Carousels)

• Polls

• LinkedIn PDF Carousels

• Pinterest Pins with a Link URL

• Google Events, Offers, and Photos

• Reels, Shorts, or Stories

Best Practices

• Choose the Right Format Select the layout that matches your content goal and platform norms.

• Follow Platform Guidelines Observe character limits, aspect ratios, and file-size rules.

• Enhance Engagement Interactive formats (polls, carousels) tend to drive higher user interaction.

• Test & Iterate Experiment across formats to discover what resonates best with your audience.

Related Topics

• Media Handling

• Publishing Methods

• Content Types

Publish posts directly to Twitter/X Communities using the Publer API. This feature enables you to reach targeted audiences and participate in focused discussions within X Communities—right from your own app or workflow.

Overview

Twitter/X Communities are spaces for people to connect, share, and discuss specific topics. Posts made in a Community are visible to anyone on X, but only Community members can engage (like, reply, etc.) with them.

• You can only post to Communities you have joined.

• Community posts help foster deeper engagement on niche topics or interests.

How It Works

To publish a post inside a Twitter/X Community via the API, you need:

• The Community ID (found in the X Community URL: https://x.com/i/communities/{COMMUNITY_ID})

• The Community Name (for reference and clarity)

• Whether to share the post with followers or not

Example Request

Set the community object inside the details for the twitter network configuration:

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "twitter": {
            "type": "status",
            "details": {
              "community": {
                "id": "1508851391443484686",
                "share_with_followers": true,
                "name": "ALBANIANS"
              }
            },
            "text": "Post to X communities"
          }
        },
        "accounts": [
          {
            "id": "66e011b94e299eb49376c715",
            "scheduled_at": "2025-07-03T10:28+02:00"
          }
        ]
      }
    ]
  }
}

How to Find the Community ID

1. Go to the Community on X.

2. Look at the URL: https://x.com/i/communities/1492410432069451776

3. The number at the end is your COMMUNITY_ID.

Important Notes

• Membership Required: You must be a member of the Community to post.

• Engagement: Only members can engage with Community posts, but all users can view them.

• Visibility: Community posts are public, but participation is limited to members.

• Scheduling: You can schedule Community posts just like any other X post using Publer.

Best Practices

• Join Relevant Communities: Ensure your X account has joined the Communities you wish to post in.

• Use for Focused Engagement: Target posts to specific Communities for more relevant discussions.

• Check Community Guidelines: Each Community may have its own moderation and content rules.

Related Topics

• Twitter/X Long-Form Posts

• Content Types Overview

Unlock the ability to schedule and publish long-form posts (up to 25,000 characters) to Twitter/X using the Publer API—exclusively for accounts with an X Premium subscription.

Overview

Twitter/X supports long-form posts (sometimes called "long posts" or "extended tweets") for users with an X Premium (formerly Twitter Blue) subscription, even at the Basic tier. These posts can contain up to 25,000 characters, far exceeding the standard 280-character limit.

With Publer, you can programmatically schedule and publish long-form posts via the API. Publer automatically detects your account’s eligibility and switches to the appropriate post type.

How It Works

• Accounts with X Premium: You can create and schedule long-form posts up to 25,000 characters.

• Accounts without X Premium: Your post text will be truncated to the standard 280-character limit, and the long-form post type will be disabled.

Tip: Validate the post length in your integration to avoid surprises when publishing.

Key Differences

• Long-form posts are not the same as Twitter threads. Threads are multiple connected posts; long-form posts are a single post with expanded character count.

• Scheduling long-form posts is not possible directly on X/Twitter—use Publer’s API or platform to achieve this functionality.

Request Example

To schedule a Twitter/X long-form post, set the network type to "long_post" inside the details object for the "twitter" network:

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "twitter": {
            "type": "status",
            "details": {
              "type": "long_post"
            },
            "text": "This is a twitter long post"
          }
        },
        "accounts": [
          {
            "id": "66e011b94e299eb49376c715",
            "scheduled_at": "2025-09-24T14:16+02:00"
          }
        ]
      }
    ]
  }
}

Important Notes

• X Premium Required: Only X Premium accounts can publish long-form posts. For other accounts, posts will be truncated to 280 characters.

• Not for Threads: Use this format for single extended posts, not for multi-part threads.

• API Detection: Publer automatically detects account eligibility for long-form posting.

• Scheduling Limitation: Twitter/X doesn’t natively support scheduling long-form posts; this is enabled via Publer’s platform and API.

Best Practices

• Check your account’s X Premium status before relying on long-form functionality.

• Always validate post length to ensure your content is not unintentionally truncated.

• Use long-form posts for in-depth announcements, articles, or detailed updates—threads remain better for sequential storytelling.

Related Topics

• Content Types Overview

• Publishing Methods

Create and schedule Facebook status updates with vibrant backgrounds to boost engagement and visual appeal.

Request Body

Include text_format_preset_id in details under the facebook network:

Parameters

Background Presets

Use one of these text_format_preset_id values to select a background:

Key Notes & Limitations

• No Other Media: Background posts cannot include images or videos.

• Facebook Pages Only: Not supported on personal profiles or groups.

• Links as Plain Text: URLs in your text appear without link previews.

• Editing: You may change—but not remove—a background on published posts.

• Character Limit: Publer allows unlimited text; Facebook enforces a 130-character cap on background posts.

• Syncing: Background posts sync back as plain text, not background posts.

Best Practices

• Select Complementary Backgrounds: Match your brand palette and message.

• Keep Copy Concise: Short, punchy text reads best over busy backgrounds.

• Preview Before Posting: Verify legibility and overall visual balance.

Related Topics

Share visually engaging Pins with an external link URL to drive traffic from Pinterest boards.

Overview

Create or schedule a Pinterest Pin by setting type: "photo", adding your media, specifying url for the external link, and the album_id to select the destination board.

Key Features

• Single API call to schedule or publish…

• Supports up to 5 photos or 1 video per Pin

• Clickable external URL

• Specify the target board with album_id

• Optional alt text for accessibility

Supported Features & Limits

Request Structure

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "pinterest": {
            "type": "photo",
            "text": "Check out our new blog post!",
            "media": [
              {
                "id": "external-0",
                "type": "photo",
                "path": "https://cdn.example.com/images/post1.jpg",
                "thumbnail": "https://cdn.example.com/images/post1-thumb.jpg",
                "alt_text": "Screenshot of our blog homepage"
              }
            ],
            "title": "Our Latest Blog Article",
            "url": "https://publer.com/blog"
          }
        },
        "accounts": [
          {
            "id": "YOUR_PINTEREST_ACCOUNT_ID",
            "scheduled_at": "2025-07-05T14:16:00+02:00",
            "album_id": "934145216398624390"
          }
        ]
      }
    ]
  }
}

Parameters

Workflow

1. Select Account & Board Add your Pinterest account.id and target album_id.

2. Upload/Reference Media Upload up to 5 photos or 1 video to Publer, then reference each with its id.

3. Compose Pin

   • Set type: "photo".

   • Provide text, title, and url.

   • Optionally add alt_text.

4. Schedule or Publish

   • To schedule, include scheduled_at.

   • To publish now, call /posts/schedule/publish or omit scheduled_at.

Best Practices

• Use high-resolution images or video for best display.

• Keep the title and text concise to encourage clicks.

• Ensure the URL is valid and leads to valuable content.

• Organize Pins into relevant Boards for better discoverability.

• Add alt text for accessibility and SEO benefits.

Related Topics

• Platform-Specific Formats

• Publishing Methods

• Content Types

Turn multiple images or documents into a scrollable PDF carousel in a single LinkedIn post. Perfect for presentations, portfolios, and multi-page documents.

Overview

Include type: "photo" and set details.type: "document" to bundle your media into a PDF carousel. You may upload images, PDFs, Word, or PowerPoint files up to 100 pages/photos.

Request Structure

Parameters

Supported Features & Limitations

Workflow

1. Upload Media Use the to upload images or documents and collect their IDs.

2. Compose Post

   • Set type: "photo", add media IDs.

   • Under details, set "type": "document".

   • Provide a title.

3. Schedule or Publish

   • Add scheduled_at under accounts to schedule.

   • Omit scheduled_at to publish immediately.

Best Practices

• Use high-resolution images or properly formatted documents for clarity.

• Craft a concise title that accurately represents the carousel content.

• Organize slides in logical order to guide viewers.

Related Topics

Share updates, photos, events, and special offers on your Google Business Profile via the Publer API. Each post type has its own fields—use the right payload to drive engagement and conversions.

Request Examples

1. Update Post

General news or announcement with an image and a CTA button.

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "google": {
            "type": "photo",
            "text": "Our new feature is live!\npubler.com",
            "title": "LEARN_MORE",
            "media": [
              {
                "id": "68133d70f09cb4aa6377d2dc",
                "path": "https://cdn.publer.com/uploads/photos/68133d70f09cb4aa6377d2dc.png",
                "thumbnail": "https://cdn.publer.com/uploads/photos/thumb_68133d70f09cb4aa6377d2dc.png",
                "type": "photo"
              }
            ]
          }
        },
        "accounts": [
          {
            "id": "GOOGLE_ACCOUNT_ID",
            "scheduled_at": "2025-05-24T08:46:00-04:00"
          }
        ]
      }
    ]
  }
}

2. Photo Post

Standalone photo update (no special details).

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "google": {
            "type": "photo",
            "details": { "type": "photo" },
            "text": "Our office view today!",
            "title": "PROFILE",
            "media": [
              {
                "id": "68133d70f09cb4aa6377d2dc",
                "path": "https://cdn.publer.com/uploads/photos/68133d70f09cb4aa6377d2dc.png",
                "thumbnail": "https://cdn.publer.com/uploads/photos/thumb_68133d70f09cb4aa6377d2dc.png",
                "type": "photo"
              }
            ]
          }
        },
        "accounts": [
          {
            "id": "GOOGLE_ACCOUNT_ID",
            "scheduled_at": "2025-05-24T08:50:00-04:00"
          }
        ]
      }
    ]
  }
}

3. Event Post

Promote an upcoming event with start/end times and an optional link.

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "google": {
            "type": "photo",
            "details": {
              "type": "event",
              "title": "Summer Workshop",
              "start": "2025-06-07T12:50:00Z",
              "end":   "2025-08-03T12:50:00Z"
            },
            "text": "Join our Summer Workshop series!",
            "title": "LEARN_MORE",
            "url": "https://publer.com/events",
            "media": [
              {
                "id": "68133d70f09cb4aa6377d2dc",
                "path": "https://cdn.publer.com/uploads/photos/68133d70f09cb4aa6377d2dc.png",
                "thumbnail": "https://cdn.publer.com/uploads/photos/thumb_68133d70f09cb4aa6377d2dc.png",
                "type": "photo"
              }
            ]
          }
        },
        "accounts": [
          {
            "id": "GOOGLE_ACCOUNT_ID",
            "scheduled_at": "2025-06-07T08:50:00-04:00"
          }
        ]
      }
    ]
  }
}

4. Offer Post

Advertise discounts or promotions with coupon codes and terms.

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "google": {
            "type": "photo",
            "details": {
              "type": "offer",
              "title": "Spring Sale",
              "start":   "2025-05-28T12:50:00Z",
              "end":     "2025-10-02T12:50:00Z",
              "coupon":  "30%OFF",
              "terms":   "https://publer.com/terms"
            },
            "text": "Enjoy 30% off sitewide!",
            "url": "https://publer.com/sale",
            "media": [
              {
                "id": "68133d70f09cb4aa6377d2dc",
                "path": "https://cdn.publer.com/uploads/photos/68133d70f09cb4aa6377d2dc.png",
                "thumbnail": "https://cdn.publer.com/uploads/photos/thumb_68133d70f09cb4aa6377d2dc.png",
                "type": "photo"
              }
            ]
          }
        },
        "accounts": [
          {
            "id": "GOOGLE_ACCOUNT_ID",
            "scheduled_at": "2025-06-14T08:50:00-04:00"
          }
        ]
      }
    ]
  }
}

Parameters

Supported Features & Limits

Workflow

1. Select Profile Choose the Google Business Profile in accounts[].id.

2. Choose Post Type

   • Update: general news with image & CTA.

   • Photo: standalone image.

   • Event: include details.type = "event", dates, and optional link.

   • Offer: include details.type = "offer", dates, coupon, and terms URL.

3. Add Media Upload or reference one photo via the Media Upload API.

4. Compose & Schedule Build your JSON, set state and scheduled_at, then POST to /posts/schedule.

Best Practices

• Use high-resolution images (≥250×250 pixels).

• Craft clear CTAs to direct user action.

• Include complete offer details (coupon & terms).

• Set accurate event dates for reliable reminders.

Related Topics

• Platform-Specific Formats

• Publishing Methods

• Content Types

Short-form, immersive content formats for deep engagement. Use Publer’s API to schedule or publish Reels (Instagram & Facebook), Shorts (YouTube), and Stories (Instagram & Facebook) with a single JSON payload.

Supported Formats & Specs

Request Structure

Send to the scheduling endpoint or use /posts/schedule/publish for immediate posting:

1. Instagram/Facebook Reel

{
  "bulk": {
    "state": "scheduled",
    "posts": [{
      "networks": {
        "instagram": {
          "type": "video",
          "text": "Our summer Reel!",
          "media": [{
            "id": "67c9630bedeb539dd87dd23c",
            "path": "https://cdn.publer.com/videos/67c9630b.mp4",
            "type": "video",
            "default_thumbnail": 1
          }],
          "details": {
            "type": "reel",
            "audio": "Custom audio name",
            "feed": false
          }
        }
      },
      "accounts": [{
        "id": "67d1f5f13d9895bab04393ec",
        "scheduled_at": "2025-07-27T14:16:00+02:00"
      }]
    }]
  }
}

2. YouTube Short

{
  "bulk": {
    "state": "scheduled",
    "posts": [{
      "networks": {
        "youtube": {
          "type": "video",
          "title": "Our Latest Short",
          "text": "Quick highlights!",
          "media": [{
            "id": "67c9630bedeb539dd87dd23c",
            "path": "https://cdn.publer.com/videos/67c9630b.mp4",
            "type": "video"
          }],
          "details": {
            "type": "short",
            "privacy": "public"
          }
        }
      },
      "accounts": [{
        "id": "64abc34d4e299e662bfd6389",
        "scheduled_at": "2025-08-01T14:16:00+02:00"
      }]
    }]
  }
}

3. Instagram/Facebook Story

{
  "bulk": {
    "state": "scheduled",
    "posts": [{
      "networks": {
        "instagram": {
          "type": "photo",
          "text": "Behind the scenes!",
          "media": [{
            "id": "680fa5cc48487c4ccbf8c146",
            "path": "https://cdn.publer.com/photos/680fa5cc.jpg",
            "type": "photo"
          }],
          "details": {
            "type": "story"
          }
        }
      },
      "accounts": [{
        "id": "67d1f5f13d9895bab04393ec",
        "scheduled_at": "2025-08-24T14:16:00+02:00"
      }]
    }]
  }
}

Common Parameters

Workflow

Reels

1. Upload: Use Media API to upload vertical video (9:16).

2. Compose: Set "details.type": "reel", optional audio and feed flags.

3. Schedule: Provide scheduled_at or publish immediately.

4. Verify: Monitor job status and preview in dashboard.

Shorts

1. Upload: Upload video ≤ 60 sec, 9:16 ratio.

2. Configure: Set "details.type": "short" and privacy.

3. Add Title/Text: Populate title and text.

4. Publish: Schedule or publish immediately.

Stories

1. Upload: Add photo or video ≤ 15 sec.

2. Tag as Story: Use "details.type": "story".

3. Caption: Add text overlay.

4. Schedule: Set scheduled_at or publish now.

Best Practices

• Use high-quality, platform-compliant media (9:16 ratio).

• Rename Reel audio to match branding.

• Schedule according to audience peak times.

Related Topics

• Platform-Specific Formats

• Publishing Methods

• Content Types