> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/hootsuite.md).

# 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/hootsuite.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
