What’s New in the Social Planner Post API
This update introduces optional platform-specific parameters and enhanced media handling for social posts created or edited via API.
No existing integrations are affected.
Supported Social Platforms
The following platforms now support their own platform-specific configuration objects:
Facebook
Instagram
LinkedIn
Pinterest
YouTube
Each platform accepts only the fields relevant to its posting rules.
Platform-Specific Fields
Each supported platform can now receive a dedicated details object when creating or editing a post.
Supported Field Examples
Depending on the platform, supported fields may include:
Post type
Title
Link or destination URL
Media format (image, video, etc.)
All platform-specific fields are optional.
If a platform object is not provided, default behavior is applied.
Media Optimization Flag
A new media optimization option improves image quality before publishing.
What Media Optimization Does
Enhances image output for supported platforms
Ensures consistent visual quality across channels
Runs automatically when the flag is enabled
This setting is optional and does not change existing behavior unless explicitly used.
API Endpoints Supporting the Update
The following endpoints support platform-specific fields and media optimization:
Create a Post
POST /social-planner/posts
Edit a Post
PUT /social-planner/posts/{id}
Retrieve Posts
GET /social-planner/posts GET /social-planner/posts/{id}Retrieved responses now include any platform-specific fields used during creation or editing.
Backward Compatibility
This update introduces no breaking changes.
Compatibility Guarantees
All new parameters are optional
Existing payloads continue to work unchanged
No migration or refactoring is required
Integrations using older request structures will behave exactly as before.
Why This Update Matters
This enhancement enables:
Unified post creation across multiple platforms
Platform-accurate content handling
Improved media quality without manual processing
Safer upgrades with zero disruption to existing workflows
FAQ
Do I need to update my existing API integration?
No. All new fields are optional and existing integrations continue to work without changes.
Can I use platform-specific fields for only one platform?
Yes. You can include platform-specific data only for the platforms you need.
What happens if I don’t include platform-specific parameters?
The post will be created using default behavior, as in previous versions of the API.
Is media optimization enabled by default?
No. Media optimization only applies if the optimization flag is explicitly set.
Which endpoints return the new fields?
Both post creation and retrieval endpoints return platform-specific fields when they are used.