Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Hootsuite

Connect to Hootsuite to schedule social media posts, review and manage the publishing calendar, upload media, and list connected social profiles.

Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

Connector
Authentication

Hootsuite

OAuth sign-in

Hootsuite

Connect to Hootsuite with your Hootsuite account to schedule, review, and manage social media posts across your connected social profiles.

Set up in Hootsuite

  1. Use a Hootsuite account with access to the records and operations that your workflow needs.

  2. If your organization restricts application access or user consent, have its administrator approve the connection before you sign in.

Set up in StackAI

  1. Open Settings → Connections, add a connection, and select Hootsuite.

  2. Select Connect, sign in to the provider account, and review the requested access. Complete authorization to return to StackAI.

  3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

StackAI obtains the OAuth credentials during sign-in. You do not need to paste an access token or refresh token.

Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

Use an action

  1. Add the required Hootsuite action to the workflow.

  2. Select a connection when the action requests one.

  3. Complete the required fields. Use the reference picker when a value comes from another workflow step.

  4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

Actions

Schedule Social Post

Schedule a social media post to one or more connected profiles in Hootsuite.

Inputs

Field
Type
Required
Description

Post Text

textarea

Yes

The message text to publish.

Social Profiles

multiple_select (string)

Yes

The social profiles to publish the post to. Options load from the selected connection.

Scheduled Send Time

datetime

Yes

When to send the post. Must be at least 5 minutes in the future.

Media IDs

array

No

IDs of media uploaded via the Upload Media action to attach. Default: [].

Tags

array

No

Hootsuite message tags to apply to the post. Default: [].

Outputs

Field
Type
Description

Scheduled Messages

object_array

The scheduled messages, one per social profile.

Message IDs

array

The IDs of the scheduled messages.

Retrieve Scheduled Messages

Retrieve scheduled or previously sent messages from Hootsuite.

Inputs

Field
Type
Required
Description

Start Time

datetime

Yes

Start of the date range to search.

End Time

datetime

Yes

End of the date range to search (max 4 weeks after start).

State

select (string)

No

Only return messages in this state. Available values: Scheduled, Pending Approval, Sent, Send Failed Permanently, Rejected. Default: .

Social Profiles

multiple_select (string)

No

Only return messages for these social profiles. Options load from the selected connection. Default: [].

Limit

integer

No

Maximum messages to return (1-100). Default: 50.

Cursor

string

No

Pagination cursor from a previous call. Default: .

Outputs

Field
Type
Description

Messages

object_array

The outbound messages in the requested window.

Next Cursor

string

Cursor for the next page; empty when there are no more results.

List Social Profiles

List the social profiles connected to the Hootsuite account.

Inputs

No input fields are required in this catalog entry.

Outputs

Field
Type
Description

Social Profiles

object_array

The social profiles the connected member has access to.

Profile IDs

array

The IDs of the social profiles.

Upload Media

Upload an image or video to Hootsuite to attach to a scheduled post.

Inputs

Field
Type
Required
Description

File URL

string

Yes

URL of the image or video to upload.

MIME Type

select (string)

No

MIME type of the file. Detected from the download when empty. Available values: PNG image, JPEG image, GIF image, MP4 video. Default: .

Wait for Processing

boolean

No

Wait until Hootsuite finishes processing the media. Default: true.

Outputs

Field
Type
Description

Media ID

string

The Hootsuite media identifier.

State

string

Processing state of the media (READY or QUEUED).

Ready

boolean

Whether the media is ready to attach to a post.

Delete Scheduled Message

Delete a scheduled message from the Hootsuite publishing queue.

Inputs

Field
Type
Required
Description

Message ID

string

Yes

The ID of the message to delete.

Outputs

Field
Type
Description

Success

boolean

Whether the message was deleted.

Message ID

string

The ID of the deleted message.

Important behavior

If an operation is denied, check the connection’s granted permissions and the account’s access in the provider. Reauthorize the connection when it needs additional permissions.

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.

Last updated

Was this helpful?