Provider readinessInterfaces and provider certification may evolve. Check account capabilities before production use.Read the readiness contract

Publish stories, reels, and short video

Model short-form placements explicitly instead of inferring them from the file alone.

Direct answer

Choose the provider placement in platform_configurations and validate it against the selected account. A vertical video does not automatically mean story or reel; the target placement, media rules, caption behavior, and provider permission must all be explicit.

What this means in practice

Choose the provider placement in platform_configurations and validate it against the selected account. A vertical video does not automatically mean story or reel; the target placement, media rules, caption behavior, and provider permission must all be explicit.

Use the documented brand and account boundaries consistently across the scheduler, REST API, SDK, MCP tools, SSE consumers, and webhooks. That makes the same social operation explainable to an operator and reproducible by an integration.

Implementation checklist

  1. Select the intended provider placement before previewing.

  2. Validate aspect ratio, duration, audio, cover image, and caption support.

  3. Use per-platform media overrides when a feed post and a story need different crops.

  4. Confirm whether the provider publishes directly or requires a draft/manual handoff.

  5. Track the provider's returned placement and remote link in target results.

Operational details

Placement names and permissions change across providers and account types.

Some short-video workflows require provider-side processing before a final permalink exists.

Analytics availability can differ between feed, reel, story, and video surfaces.

Common mistakes to avoid

Protect intent, tenant boundaries, and provider state.
  • Do not choose placement from dimensions alone.
  • Do not promise direct story publication when the account capability is read-only or draft-only.
  • Do not reuse a feed thumbnail as a short-video cover without previewing the crop.

Was this useful? This documentation is reviewed against the public App9 Post contract. Use the API reference and live capability response for machine-enforced details.

Open API reference