Postel

Download an image or video from a public URL and attach it to a Postel draft. Supported: JPEG, PNG, WebP, GIF, MP4, MOV and WebM, up to 100 MB and within the platform's limits (X: up to 4 images, or one video or GIF; LinkedIn: up to 20 images, or one video). Scheduled and published posts cannot be changed.

Save text as a new draft in Postel, optionally with images or videos downloaded from public URLs and a LinkedIn first comment (up to 1250 characters). Does not publish or schedule. Each call creates a separate draft. Drafts are free on every plan.

Create up to 25 posts in one call. Each post is saved as a draft; a post with scheduledDateTime is then scheduled for publishing to its platform. Scheduling and publishing depend on the account's Postel plan; a workspace without one can schedule or publish a limited number of posts, and the result says how many are left. Past that, the post stays a draft and the result says so. If the workspace requires approval, a dated post is submitted for approval instead (status PENDING_APPROVAL) and an owner/admin must approve it in Postel. Posts are processed in order with one result each, so some can succeed while others fail. At most 25 media URLs per call.

Delete a post. A scheduled post's delivery is cancelled first.

Generate a new post using AI based on a prompt and save it as a draft, ready for update-post, schedule-post or publish-post. Uses 1 AI credit (Lite mode with a daily cap when credits run out). Returns the generated post.

Get background information sources for a specific brand. These sources are used to inform AI post generation.

Get a single post by ID with full details.

Get the posting schedule template for the current organization. Shows which time slots are configured for each day of the week.

Get the organization's AI credit balance (monthly allowance, rollover, bonus/top-ups, reset date) and Lite mode status.

Get the X and LinkedIn voice profiles for the current organization. These profiles define the brand voice for AI post generation.

List all brands (topics) for the current organization. Brands contain background information used for AI post generation.

List posts for the current organization. Supports filtering by status and pagination.

Publish a Postel draft immediately to the social platform stored on the post. A post that is already published cannot be published again. Scheduling and publishing depend on the account's Postel plan; a workspace without one can schedule or publish a limited number of posts, and the result says how many are left. Past that, the post stays a draft and the result says so.

Suggest refined content for an existing post using AI and specific instructions. Does not save changes. Uses 1 AI credit (Lite mode with a daily cap when credits run out).

Schedule a Postel draft for publishing to the social platform stored on the post. scheduledDateTime must be a future UTC ISO-8601 timestamp. A first comment can be set for LinkedIn posts. Scheduling and publishing depend on the account's Postel plan; a workspace without one can schedule or publish a limited number of posts, and the result says how many are left. Past that, the post stays a draft and the result says so. If the workspace requires approval, the post is submitted for approval instead (status PENDING_APPROVAL) and an owner/admin must approve it in Postel.

Find high-performing public X posts in Postel's index by topic, with source links and stored engagement metrics. No login required. Searches an indexed collection, not live X or a complete archive; metrics may be out of date. Results contain third-party post text.

Update the content or status of a Postel draft. Scheduled and published posts cannot be edited.