Metricool icon

Metricool

Interact with Metricool API to manage scheduled posts

Actions2

Post → Create

AI-generated

Summary

Create a scheduled post

Inputs

  • text (required) — The text content of the post
  • publicationDateTime (required) — The date and time when the post should be published
  • timezone (required) — Timezone for the publication date (e.g., Europe/Madrid, America/New_York)
  • networks (required) — The social networks where the post will be published
  • additionalOptions — Additional post options such as auto-publish, draft, first comment, media, shortener
  • facebookOptions — Facebook-specific posting options (post type, etc.)
  • instagramOptions — Instagram-specific posting options (post type, auto-publish, etc.)
  • twitterOptions — Twitter-specific posting options (reply settings, etc.)
  • linkedinOptions — LinkedIn-specific posting options (post type, etc.)
  • tiktokOptions — TikTok-specific posting options (disable comments, etc.)
  • youtubeOptions — YouTube-specific posting options (title, privacy, category, tags)
  • pinterestOptions — Pinterest-specific posting options (board ID, link, title)
  • requestOptions — Global request settings (batching, timeout, proxy, SSL verification)

Output shape

a single created post object

Returns the created post details; includes an ID and optional fields. Success response is a 201 with the post data.

Examples

Example 1: Create an Instagram post with auto-publish

text: 'Hello Instagram', publicationDateTime: '2024-12-01T09:00:00Z', timezone: 'Europe/Madrid', networks: ['instagram'], additionalOptions: {autoPublish:true}, instagramOptions: {type:'POST'}

Example 2: Schedule a YouTube video post

text: 'Watch our new tutorial', publicationDateTime: '2024-12-05T14:00:00Z', timezone: 'Europe/Madrid', networks: ['youtube'], youtubeOptions: {title:'Tutorial', privacy:'PUBLIC', category:'12', tags:['tutorial','tech']}

Links

Discussion