Action: Create Media Upload Job

Hootsuite Operation

The Create Media Upload Job action initiates an asynchronous process to upload media files to the platform.

Example User Story

I want to create a media upload job in Hootsuite so that I can schedule posts with images or videos to multiple platforms.

Fields

Field Name	Field Type	Required
filePath	String	Yes
socialNetwork	String	Yes
scheduledTime	String	No

Related Connections

Hootsuite

Related Automations

Example link

Code (Apache v2.0): Operation

{
  "handle": "create-media-upload-job",
  "state": "inDev",
  "meta": {
    "short": "Create Media Upload Job",
    "description": "Creates a new media upload job in Hootsuite for scheduling social media posts."
  },
  "input": [
    {
      "name": "filePath",
      "type": "String",
      "required": true,
      "meta": {
        "description": "Path to the media file to be uploaded."
      }
    },
    {
      "name": "socialNetwork",
      "type": "String",
      "required": true,
      "meta": {
        "description": "The target social network for the media upload (e.g., Twitter, Facebook)."
      }
    },
    {
      "name": "scheduledTime",
      "type": "String",
      "required": false,
      "meta": {
        "description": "Optional scheduled time for the post in ISO 8601 format."
      }
    }
  ],
  "output": [
    {
      "name": "jobId",
      "type": "String",
      "selector": ["response", "data", "id"],
      "meta": {
        "description": "The unique identifier for the created media upload job."
      }
    },
    {
      "name": "status",
      "type": "String",
      "selector": ["response", "data", "status"],
      "meta": {
        "description": "The current status of the media upload job."
      }
    }
  ],
  "steps": [
    {
      "type": "http",
      "http": {
        "method": "POST",
        "path": "/media/upload",
        "headers": {
          "Content-Type": "application/json"
        },
        "bodyTemplate": {
          "value": "{\"filePath\":\"{{filePath}}\",\"socialNetwork\":\"{{socialNetwork}}\",\"scheduledTime\":\"{{scheduledTime}}\"}",
          "placeholders": [
            {
              "name": "filePath",
              "type": "String",
              "description": "Path to the media file to be uploaded.",
              "required": true
            },
            {
              "name": "socialNetwork",
              "type": "String",
              "description": "The target social network for the media upload.",
              "required": true
            },
            {
              "name": "scheduledTime",
              "type": "String",
              "description": "Optional scheduled time for the post.",
              "required": false
            }
          ]
        }
      }
    }
  ]
}