Scheduling and Managing the Post Lifecycle

With Post for Me, you can seamlessly manage the entire lifecycle of your social media content, from initial drafts to future scheduled campaigns.

Here is a breakdown of how to schedule posts, understand their lifecycle, and manage updates.

Drafts vs. Scheduled Posts

When creating a post, you have complete control over when it goes live.

How it works

You dictate the publishing timeline using two specific payload properties when creating a post:

• Drafts: To save a work-in-progress, pass the isDraft boolean flag as true. This tells the system that the post is not ready and should not be processed.

• Scheduled: To queue a post for a future date, pass a valid date-time string in the scheduled_at field.

• Instant: If you set scheduled_at to null or omit it entirely (and isDraft is false), the post will be published instantly.

The Post Statuses

As a post moves through our system, its status field automatically updates to reflect its current state.

The Lifecycle: A post will transition through the following tracking statuses:

1. draft: The post is safely stored but will not be published.

2. scheduled: The post is queued and waiting for its scheduled_at time to arrive.

3. processing: The time has arrived, and the post is actively being handed off to the targeted social platforms.

4. processed: The API has finished its publishing attempt across all targeted accounts.

Updating and Deleting Posts

Content plans change, and the API allows you to modify or cancel posts before they go live.

How it works

You can modify an existing post's caption, media, or timing by making a PUT request to the /v1/social-posts/{id} endpoint. If you need to cancel it entirely, you can make a DELETE request to the /v1/social-posts/{id} endpoint.

Requirement: It’s important to note that you can only update or delete a post if its current status is draft or scheduled. Once a post transitions to processing or is fully processed, it can no longer be altered or deleted.