When creating a standard post with Post for Me, the basics are simple: you need a caption, optional media, and the target social accounts. However, when you need granular control over how content appears on specific networks, we offer two powerful tools: platform_configurations and account_configurations.
Here is a breakdown of how to utilize overrides to customize your posting flow.
The Cascading Logic
Just like CSS, the Post for Me API applies settings in a cascading style where the most specific configuration takes precedence.
How it works
The system checks for settings in the following order:
Account Configuration (Highest Priority)
Platform Configuration
Base Post (Lowest Priority)
Example
If you set a generic caption on the base post, a specific caption in platform_configurations, and a third caption in account_configurations, the account configuration caption will be the one published to that specific account.
Platform Configurations
Platform configurations allow you to set overrides and details that apply to all accounts of a specific platform included in the post request.
How it works
You pass a platform_configurations object containing keys for the specific networks (e.g., tiktok, youtube, instagram). Any setting defined here will automatically apply to every account matching that platform type.
Use Case
This is ideal for ensuring all TikTok uploads have comments enabled, or ensuring all Instagram posts are published as Reels rather than timeline posts. Additionally if you want all Instagram accounts to have a slightly different caption then all of the TikTok ones then this is how you would do it.
Account Configurations
Account configurations provide the highest level of specificity, allowing you to set overrides for a single, specific social_account_id.
How it works
You pass an array of objects, each specifying a social_account_id and a configuration object. These settings will only apply to that exact account.
Use Case
Use this when you are posting to multiple accounts on the same platform but need different settings for each. For example, if one Instagram account needs to tag a specific collaborator, while another does not.
Advanced Configuration Options
You can set a wide variety of platform-specific options under both the platform_configurations and account_configurations. Here are a few powerful examples:
TikTok: Set a specific title, control privacy_status (public/private), or manage engagement settings like allow_duet and allow_comment.
YouTube: Set a specific title, control privacy_status, or indicate if the video was made_for_kids
Instagram: Define the placement (Reels vs. Stories), tag collaborators, or specify the trial_reel_type (manual or performance).
Facebook: Control placement (Reels vs. Timeline) or add location tags to your posts.
Pinterest: Assign specific board_ids or set a custom destination link for the pin.
For a complete list of every available parameter for each platform, please refer to the documentation.