Actions44
- AI Image Actions
- AI Video Actions
- Approval Workflow Actions
- Auth Actions
- Campaign Actions
- Comment Actions
- Content Category Actions
- Label Actions
- Media Actions
- Post Actions
- Scheduling Actions
- Social Account Actions
- Team Member Actions
- Workspace Actions
Scheduling → Best Times to Post
AI-generatedSummary
Analyze connected social accounts’ publishing history and return recommended posting times in the workspace timezone. Choose pooled ranked slots, pooled plus per-account slots, or the full API response with its heatmap matrix.
Inputs
- Workspace ID (required) — Workspace to analyze.
- Accounts — Accounts to analyze; leave empty to include every connected account. Blog-style connections are excluded from the picker.
- Output — Choose Ranked Slots (Pooled), Ranked Slots (Pooled + Per Account), or Full Response. Defaults to pooled ranked slots.
- Pooled Slots — Number of pooled recommendations to return, from 1 to 24; defaults to 5.
- Per Account Slots — Number of recommendations per account, from 1 to 24; defaults to 3.
Output shape
A list of items.
Ranked slot modes flatten recommendations into one item per slot, best first. Each slot includes scheduled_at in YYYY-MM-DD HH:MM:SS format and the workspace timezone; pooled plus per-account mode also includes account-level recommendations. If no slots are ranked, the operation returns a single metadata item. Full Response returns the raw API payload, including the heatmap matrix. The API analyzes all available publishing history and has no period or timezone parameter.