Hootsuite Integration

Field	Description	Required	Format
Client ID	Hootsuite OAuth App Client ID	Yes	`-`
Client Secret	Hootsuite OAuth App Client Secret	Yes	`-`

create_media_upload_job — Creates a new media upload job on Hootsuite by uploading a file from a public URL

Parameters

integer

required

The size of the file in bytes

string

required

The MIME type of the file (e.g. image/png, image/jpeg, video/mp4)

string

required

A publicly-accessible URL to the file to upload

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "file_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "File Id"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateMediaUploadJobOutput",
  "type": "object"
}

get_media_upload_status — Gets the status of a media upload job on Hootsuite

Parameters

string

required

The ID of the media file to check status for

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "state": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "State"
    },
    "download_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Download Url"
    },
    "thumbnail_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Thumbnail Url"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetMediaUploadStatusOutput",
  "type": "object"
}

Response

{
  "$defs": {
    "SocialProfile": {
      "additionalProperties": false,
      "description": "A Hootsuite social profile.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Type"
        },
        "social_network_username": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Social Network Username"
        },
        "social_network_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Social Network Id"
        }
      },
      "title": "SocialProfile",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "profiles": {
      "items": {
        "$ref": "#/$defs/SocialProfile"
      },
      "title": "Profiles",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListSocialProfilesOutput",
  "type": "object"
}

Parameters

string

required

The message text to publish

Array of social profile ID strings to post to (use list_social_profiles to discover IDs)

string

ISO-8601 UTC time to send the message (must end with ‘Z’). If omitted, sends immediately.

array

Array of ow.ly media URLs to attach to the message

array

Array of media IDs from create_media_upload_job to attach

array

Array of Hootsuite message tags to apply (case sensitive)

array

Array of webhook URLs to call when message state changes

object

Targeting object for Facebook Page and LinkedIn Company posts. See Hootsuite API docs for structure.

object

Privacy settings object with optional facebook.visibility and linkedIn.visibility arrays

number

Latitude in decimal degrees (-90 to 90)

number

Longitude in decimal degrees (-180 to 180)

boolean

Whether to send email notification when the message is published

Response

{
  "$defs": {
    "ScheduledMessage": {
      "additionalProperties": false,
      "description": "A scheduled message returned by the Hootsuite API.",
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "state": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "State"
        },
        "text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Text"
        },
        "scheduled_send_time": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Scheduled Send Time"
        }
      },
      "title": "ScheduledMessage",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "messages": {
      "items": {
        "$ref": "#/$defs/ScheduledMessage"
      },
      "title": "Messages",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "ScheduleMessageOutput",
  "type": "object"
}

Using

Providers

Building

Tools

Hootsuite Integration for AI Agents & Workflows

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

Available Actions

Parameters

Response

Parameters

Response

Limits & Quotas

LinkedIn

Product Hunt

Ahrefs

Links

​Overview

​Authentication

​OAuth2 Authentication

​Required Credentials

​OAuth Configuration

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

LinkedIn

Product Hunt

Ahrefs

​Links

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

Available Actions

Parameters

Response

Parameters

Response

Response

Parameters

Response

Limits & Quotas

Related integrations

Links