Action: Schedule Message

Hootsuite Operation

The Schedule Message action queues a social media post for future publication at a specified time.

Example User Story

I want to schedule a message to be posted on multiple social networks at a specific time so that I can plan my content calendar efficiently.

Fields

Field Name	Field Type	Required
message	String	Yes
socialNetworks	String	Yes
scheduleTime	String	Yes
timezone	String	No

Related Connections

Hootsuite

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "schedule-message",
  "state": "inDev",
  "meta": {
    "short": "Schedule Message",
    "description": "Schedule a message to be posted on social media platforms via Hootsuite."
  },
  "input": [
    {
      "name": "message",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The content of the message to be scheduled."
      }
    },
    {
      "name": "socialNetworks",
      "type": "String",
      "required": true,
      "meta": {
        "description": "Comma-separated list of social networks to post the message (e.g., 'twitter,facebook')."
      }
    },
    {
      "name": "scheduleTime",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The time to schedule the message in ISO 8601 format (e.g., '2026-03-18T12:00:00Z')."
      }
    },
    {
      "name": "timezone",
      "type": "String",
      "required": false,
      "meta": {
        "description": "The timezone for the scheduled time (e.g., 'America/New_York'). Defaults to UTC if not provided."
      }
    }
  ],
  "output": [
    {
      "name": "messageId",
      "type": "String",
      "selector": ["id"],
      "meta": {
        "description": "The ID of the scheduled message."
      }
    },
    {
      "name": "status",
      "type": "String",
      "selector": ["status"],
      "meta": {
        "description": "The status of the scheduling request."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/messages",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"message\":{\"text\":\"{{message}}\",\"socialNetworks\":[\"{{socialNetworks}}\"],\"scheduledAt\":\"{{scheduleTime}}\",\"timezone\":\"{{timezone}}\"}}",
          "placeholders": [
            {
              "name": "message",
              "type": "String",
              "description": "The content of the message to be scheduled.",
              "required": true
            },
            {
              "name": "socialNetworks",
              "type": "String",
              "description": "Comma-separated list of social networks to post the message.",
              "required": true
            },
            {
              "name": "scheduleTime",
              "type": "String",
              "description": "The time to schedule the message in ISO 8601 format.",
              "required": true
            },
            {
              "name": "timezone",
              "type": "String",
              "description": "The timezone for the scheduled time.",
              "required": false
            }
          ]
        }
      }
    }
  ]
}