# Hootsuite

> Schedule posts to your social media accounts through Hootsuite, with images and videos, find, approve, reject and delete posts, and look up your social profiles, teams and members. Start workflows when a post is waiting for approval, is sent or fails to send.

App · 22 actions. Web page: https://docs.lodol.com/docs/integrations/hootsuite

## Actions

### Approve a post

Approve a post that is waiting for your approval.

**Inputs**

- Post ID (`message_id`, text, required): The post's ID, from 'Schedule a post', 'Find posts' or a trigger.

**Outputs**

- `approved` (true/false): True once approved
- `message` (object): A post to one social profile
- `message_id` (text): The post's ID

**Example output**

```json
{
  "approved": true,
  "message": {
    "approval_step": 0,
    "created_by_member_id": "15240789",
    "id": "4138476039",
    "last_updated_by_member_id": "15240789",
    "media_ids": [
      "aHR0cDovL2V4YW1wbGUub3Jn"
    ],
    "media_urls": [],
    "post_id": "",
    "post_url": "",
    "reviewer_ids": [
      "22421144"
    ],
    "scheduled_send_time": "2026-11-02T14:00:00Z",
    "social_profile_id": "115185509",
    "social_profile_url": "https://www.facebook.com/pammythedog",
    "state": "SCHEDULED",
    "state_name": "Scheduled",
    "tags": [
      "launch"
    ],
    "text": "5 trends that will change how we use social media this year"
  },
  "message_id": "4138476039"
}
```

### Check an upload

Check whether an uploaded image or video is ready to attach to a post.

**Inputs**

- Media ID (`media_id`, text, required): The media ID from 'Upload an image or video'.

**Outputs**

- `media` (object): An image or video uploaded to Hootsuite

**Example output**

```json
{
  "media": {
    "download_url": "https://hootsuiteapis.s3-us-east-1.amazonaws.com/2147563588/5eb2d61a",
    "id": "aHR0cHM6Ly9ob290c3VpdGUtdmlkZW8uczMuYW1hem9uYXdzLmNvbS9wcm9kdWN0aW9u",
    "ready": true,
    "state": "READY"
  }
}
```

### Delete a post

Delete a scheduled post, or one waiting for approval, so it is never sent.

**Inputs**

- Post ID (`message_id`, text, required): The post's ID, from 'Schedule a post', 'Find posts' or a trigger.

**Outputs**

- `deleted` (true/false): True once deleted
- `message_id` (text): The deleted post's ID

**Example output**

```json
{
  "deleted": true,
  "message_id": "4138476039"
}
```

### Find posts

Find posts scheduled or sent between two times (up to 4 weeks apart), optionally by state and social profile.

**Inputs**

- From (`start_time`, date and time): The start of the window. Defaults to now.
- To (`end_time`, date and time): The end of the window, at most 4 weeks after From. Defaults to 4 weeks after From.
- State (`state`, text): Only posts in this state. One of: `any`, `SCHEDULED`, `PENDING_APPROVAL` (Waiting for approval), `SENT`, `SEND_FAILED_PERMANENTLY` (Failed to send), `REJECTED`. Default: `any`.
- Social profiles (`social_profile_ids`, list): Only posts to these profiles. Leave empty for all.
- Limit (`limit`, number): How many to return, 1 to 100. From 1 to 100. Default: `50`.
- Next page (`cursor`, text): The next_page value an earlier step returned, to get the page after it.

**Outputs**

- `count` (number): How many there are
- `end_time` (text): The window's end (UTC)
- `messages` (list): The posts, earliest first
- `next_page` (text): Pass as Next page for more; empty when there are no more
- `start_time` (text): The window's start (UTC)

**Example output**

```json
{
  "count": 1,
  "end_time": "2026-11-29T00:00:00Z",
  "messages": [
    {
      "approval_step": 0,
      "created_by_member_id": "15240789",
      "id": "4138476039",
      "last_updated_by_member_id": "15240789",
      "media_ids": [
        "aHR0cDovL2V4YW1wbGUub3Jn"
      ],
      "media_urls": [],
      "post_id": "",
      "post_url": "",
      "reviewer_ids": [],
      "scheduled_send_time": "2026-11-02T14:00:00Z",
      "social_profile_id": "115185509",
      "social_profile_url": "https://www.facebook.com/pammythedog",
      "state": "SCHEDULED",
      "state_name": "Scheduled",
      "tags": [
        "launch"
      ],
      "text": "5 trends that will change how we use social media this year"
    }
  ],
  "next_page": "",
  "start_time": "2026-11-01T00:00:00Z"
}
```

### Get a member

Get a Hootsuite member's name, email, time zone and more.

**Inputs**

- Member ID (`member_id`, text, required): The member's ID, from another Hootsuite step.

**Outputs**

- `member` (object): A Hootsuite member (a person with a Hootsuite login)

**Example output**

```json
{
  "member": {
    "bio": "I am Joe Smith",
    "company_name": "Hootsuite",
    "created_date": "2013-05-29T13:27:24Z",
    "email": "jsmith@example.com",
    "full_name": "Joe Smith",
    "id": "15240789",
    "is_active": true,
    "language": "en",
    "modified_date": "2013-05-29T13:27:24Z",
    "timezone": "America/Vancouver"
  }
}
```

### Get a post

Get a post: its text, state, send time and, once sent, where it is live.

**Inputs**

- Post ID (`message_id`, text, required): The post's ID, from 'Schedule a post', 'Find posts' or a trigger.

**Outputs**

- `message` (object): A post to one social profile

**Example output**

```json
{
  "message": {
    "approval_step": 0,
    "created_by_member_id": "15240789",
    "id": "4138476039",
    "last_updated_by_member_id": "15240789",
    "media_ids": [
      "aHR0cDovL2V4YW1wbGUub3Jn"
    ],
    "media_urls": [],
    "post_id": "",
    "post_url": "",
    "reviewer_ids": [],
    "scheduled_send_time": "2026-11-02T14:00:00Z",
    "social_profile_id": "115185509",
    "social_profile_url": "https://www.facebook.com/pammythedog",
    "state": "SCHEDULED",
    "state_name": "Scheduled",
    "tags": [
      "launch"
    ],
    "text": "5 trends that will change how we use social media this year"
  }
}
```

### Get a post's approval history

See who created, edited, approved or rejected a post, and when.

**Inputs**

- Post ID (`message_id`, text, required): The post's ID, from 'Schedule a post', 'Find posts' or a trigger.

**Outputs**

- `actions` (list): What happened, in order
- `count` (number): How many there are
- `message_id` (text): The post's ID

**Example output**

```json
{
  "actions": [
    {
      "action": "CREATE",
      "actor_id": "12345678",
      "actor_type": "MEMBER",
      "timestamp": "2017-02-15T18:51:13.000Z"
    }
  ],
  "count": 1,
  "message_id": "4138476039"
}
```

### Get a social profile

Get one social profile: its network, name, owner and whether it needs reconnecting in Hootsuite.

**Inputs**

- Social profile (`social_profile_id`, text, required): The social profile: pick one, or use an ID from an earlier step.

**Outputs**

- `social_profile` (object): A social profile: one account on a social network that Hootsuite posts to

**Example output**

```json
{
  "social_profile": {
    "avatar_url": "https://scontent.xx.fbcdn.net/v/t1.0-1/p300x500/10354686_n.jpg",
    "id": "115185509",
    "needs_reconnecting": false,
    "network": "FACEBOOKPAGE",
    "network_name": "Facebook Page",
    "owner": "ORGANIZATION",
    "owner_id": "626731",
    "social_network_id": "1261768027866378",
    "username": "Pammy The Dog"
  }
}
```

### Get a team

Get a Hootsuite team's name and when it was created.

**Inputs**

- Team (`team`, text, required): The team: pick one, or use an ID from an earlier step.

**Outputs**

- `team` (object): A team in a Hootsuite organization

**Example output**

```json
{
  "team": {
    "created_by_member_id": "13892119232",
    "created_date": "2016-01-14T16:27:40Z",
    "id": "359493",
    "logo_url": "http://ow.ly/i/logo.png",
    "modified_date": "2016-01-14T16:27:40Z",
    "name": "North America Support Team"
  }
}
```

### Get my account

Get the Hootsuite account Lodol is signed in as: name, email and ID.

**Inputs**: None.

**Outputs**

- `member` (object): A Hootsuite member (a person with a Hootsuite login)

**Example output**

```json
{
  "member": {
    "bio": "I am Joe Smith",
    "company_name": "Hootsuite",
    "created_date": "2013-05-29T13:27:24Z",
    "email": "jsmith@example.com",
    "full_name": "Joe Smith",
    "id": "15240789",
    "is_active": true,
    "language": "en",
    "modified_date": "2013-05-29T13:27:24Z",
    "timezone": "America/Vancouver"
  }
}
```

### List a member's social profiles

List the organization's social profiles a member can use.

**Inputs**

- Member ID (`member_id`, text): The member's ID. Leave empty for yourself.
- Organization (`organization_id`, text): The Hootsuite organization. Leave empty to use yours (the first, if you're in several).

**Outputs**

- `count` (number): How many there are
- `member_id` (text): The member's ID
- `social_profiles` (list): The social profiles

**Example output**

```json
{
  "count": 1,
  "member_id": "15240789",
  "social_profiles": [
    {
      "avatar_url": "https://scontent.xx.fbcdn.net/v/t1.0-1/p300x500/10354686_n.jpg",
      "id": "115185509",
      "needs_reconnecting": false,
      "network": "FACEBOOKPAGE",
      "network_name": "Facebook Page",
      "owner": "ORGANIZATION",
      "owner_id": "626731",
      "social_network_id": "1261768027866378",
      "username": "Pammy The Dog"
    }
  ]
}
```

### List a member's teams

List the teams a member of your Hootsuite organization is in.

**Inputs**

- Member ID (`member_id`, text): The member's ID. Leave empty for yourself.
- Organization (`organization_id`, text): The Hootsuite organization. Leave empty to use yours (the first, if you're in several).

**Outputs**

- `count` (number): How many there are
- `member_id` (text): The member's ID
- `teams` (list): The teams

**Example output**

```json
{
  "count": 1,
  "member_id": "15240789",
  "teams": [
    {
      "created_by_member_id": "13892119232",
      "created_date": "2016-01-14T16:27:40Z",
      "id": "359493",
      "logo_url": "http://ow.ly/i/logo.png",
      "modified_date": "2016-01-14T16:27:40Z",
      "name": "North America Support Team"
    }
  ]
}
```

### List a team's social profiles

List the social profiles a Hootsuite team can use.

**Inputs**

- Team (`team`, text, required): The team: pick one, or use an ID from an earlier step.
- Organization (`organization_id`, text): The Hootsuite organization. Leave empty to use yours (the first, if you're in several).

**Outputs**

- `count` (number): How many there are
- `social_profiles` (list): The social profiles
- `team_id` (text): The team's ID

**Example output**

```json
{
  "count": 1,
  "social_profiles": [
    {
      "avatar_url": "https://scontent.xx.fbcdn.net/v/t1.0-1/p300x500/10354686_n.jpg",
      "id": "115185509",
      "needs_reconnecting": false,
      "network": "FACEBOOKPAGE",
      "network_name": "Facebook Page",
      "owner": "ORGANIZATION",
      "owner_id": "626731",
      "social_network_id": "1261768027866378",
      "username": "Pammy The Dog"
    }
  ],
  "team_id": "359493"
}
```

### List my organizations

List the Hootsuite organizations your account belongs to.

**Inputs**: None.

**Outputs**

- `count` (number): How many there are
- `organizations` (list): The organizations

**Example output**

```json
{
  "count": 1,
  "organizations": [
    {
      "id": "626731",
      "logo_url": "https://assets.hootsuite.com/avatars_production/organization/12345_owl.gif",
      "name": "Test Organization"
    }
  ]
}
```

### List organization members

List everyone in your Hootsuite organization, with names and emails.

**Inputs**

- Organization (`organization_id`, text): The Hootsuite organization. Leave empty to use yours (the first, if you're in several).

**Outputs**

- `count` (number): How many there are
- `members` (list): The members
- `organization_id` (text): The organization's ID

**Example output**

```json
{
  "count": 1,
  "members": [
    {
      "bio": "I am Joe Smith",
      "company_name": "Hootsuite",
      "created_date": "2013-05-29T13:27:24Z",
      "email": "jsmith@example.com",
      "full_name": "Joe Smith",
      "id": "15240789",
      "is_active": true,
      "language": "en",
      "modified_date": "2013-05-29T13:27:24Z",
      "timezone": "America/Vancouver"
    }
  ],
  "organization_id": "626731"
}
```

### List social profiles

List the social media accounts you can post to through Hootsuite, optionally from one network.

**Inputs**

- Network (`network`, text): Only list profiles on this network. One of: `any` (Every network), `FACEBOOKPAGE` (Facebook Page), `FACEBOOK` (Facebook profile), `INSTAGRAMBUSINESS` (Instagram business account), `INSTAGRAM` (Instagram personal account), `LINKEDINCOMPANY` (LinkedIn Page), `LINKEDIN` (LinkedIn profile), `TWITTER` (X (Twitter)), `PINTEREST`, `THREADS`, and 3 more. Default: `any`.

**Outputs**

- `count` (number): How many there are
- `social_profiles` (list): The social profiles

**Example output**

```json
{
  "count": 1,
  "social_profiles": [
    {
      "avatar_url": "https://scontent.xx.fbcdn.net/v/t1.0-1/p300x500/10354686_n.jpg",
      "id": "115185509",
      "needs_reconnecting": false,
      "network": "FACEBOOKPAGE",
      "network_name": "Facebook Page",
      "owner": "ORGANIZATION",
      "owner_id": "626731",
      "social_network_id": "1261768027866378",
      "username": "Pammy The Dog"
    }
  ]
}
```

### List team members

List the members of a Hootsuite team, with names and emails.

**Inputs**

- Team (`team`, text, required): The team: pick one, or use an ID from an earlier step.
- Organization (`organization_id`, text): The Hootsuite organization. Leave empty to use yours (the first, if you're in several).

**Outputs**

- `count` (number): How many there are
- `members` (list): The members
- `team_id` (text): The team's ID

**Example output**

```json
{
  "count": 1,
  "members": [
    {
      "bio": "I am Joe Smith",
      "company_name": "Hootsuite",
      "created_date": "2013-05-29T13:27:24Z",
      "email": "jsmith@example.com",
      "full_name": "Joe Smith",
      "id": "15240789",
      "is_active": true,
      "language": "en",
      "modified_date": "2013-05-29T13:27:24Z",
      "timezone": "America/Vancouver"
    }
  ],
  "team_id": "359493"
}
```

### List teams

List the teams in your Hootsuite organization.

**Inputs**

- Organization (`organization_id`, text): The Hootsuite organization. Leave empty to use yours (the first, if you're in several).

**Outputs**

- `count` (number): How many there are
- `organization_id` (text): The organization's ID
- `teams` (list): The teams

**Example output**

```json
{
  "count": 1,
  "organization_id": "626731",
  "teams": [
    {
      "created_by_member_id": "13892119232",
      "created_date": "2016-01-14T16:27:40Z",
      "id": "359493",
      "logo_url": "http://ow.ly/i/logo.png",
      "modified_date": "2016-01-14T16:27:40Z",
      "name": "North America Support Team"
    }
  ]
}
```

### List teams with access to a social profile

List the Hootsuite teams that can use a social profile.

**Inputs**

- Social profile (`social_profile_id`, text, required): The social profile: pick one, or use an ID from an earlier step.

**Outputs**

- `count` (number): How many there are
- `teams` (list): The teams

**Example output**

```json
{
  "count": 1,
  "teams": [
    {
      "created_by_member_id": "13892119232",
      "created_date": "2016-01-14T16:27:40Z",
      "id": "359493",
      "logo_url": "http://ow.ly/i/logo.png",
      "modified_date": "2016-01-14T16:27:40Z",
      "name": "North America Support Team"
    }
  ]
}
```

### Reject a post

Reject a post that is waiting for your approval, telling its author why.

**Inputs**

- Post ID (`message_id`, text, required): The post's ID, from 'Schedule a post', 'Find posts' or a trigger.
- Reason (`reason`, text, required): Why it's rejected. Hootsuite shows this to the post's author.

**Outputs**

- `message` (object): A post to one social profile
- `message_id` (text): The post's ID
- `rejected` (true/false): True once rejected

**Example output**

```json
{
  "message": {
    "approval_step": 0,
    "created_by_member_id": "15240789",
    "id": "4138476039",
    "last_updated_by_member_id": "15240789",
    "media_ids": [
      "aHR0cDovL2V4YW1wbGUub3Jn"
    ],
    "media_urls": [],
    "post_id": "",
    "post_url": "",
    "reviewer_ids": [],
    "scheduled_send_time": "2026-11-02T14:00:00Z",
    "social_profile_id": "115185509",
    "social_profile_url": "https://www.facebook.com/pammythedog",
    "state": "REJECTED",
    "state_name": "Rejected",
    "tags": [
      "launch"
    ],
    "text": "5 trends that will change how we use social media this year"
  },
  "message_id": "4138476039",
  "rejected": true
}
```

### Schedule a post

Schedule a post to one or more social profiles, with images or videos if you like. Leave the send time empty to post as soon as possible.

**Inputs**

- Text (`text`, text, required): What the post says.
- Social profiles (`social_profile_ids`, list, required): Where to post: pick one or more of your social profiles. Hootsuite makes one post for each.
- Send time (`send_time`, date and time): When to post, at least 5 minutes from now (15 for a video). Leave empty to post as soon as possible.
- Images or videos (`media`, list): Web addresses of JPG, PNG or GIF images or MP4 or MOV videos to attach; Lodol uploads them to Hootsuite. A media ID from 'Upload an image or video' works too.
- Tags (`tags`, list): Hootsuite tags to add, exactly as named in Hootsuite. Only for profiles your organization owns.
- Email me when it's sent (`email_notification`, true/false): Have Hootsuite email you when the post goes out. Default: `false`.

**Outputs**

- `count` (number): How many there are
- `message_id` (text): ID of the first post made (one is made per profile)
- `messages` (list): One post per social profile
- `problems` (text): What Hootsuite refused, if it refused some profiles

**Example output**

```json
{
  "count": 1,
  "message_id": "4138476039",
  "messages": [
    {
      "approval_step": 0,
      "created_by_member_id": "15240789",
      "id": "4138476039",
      "last_updated_by_member_id": "15240789",
      "media_ids": [
        "aHR0cDovL2V4YW1wbGUub3Jn"
      ],
      "media_urls": [],
      "post_id": "",
      "post_url": "",
      "reviewer_ids": [],
      "scheduled_send_time": "2026-11-02T14:00:00Z",
      "social_profile_id": "115185509",
      "social_profile_url": "https://www.facebook.com/pammythedog",
      "state": "SCHEDULED",
      "state_name": "Scheduled",
      "tags": [
        "launch"
      ],
      "text": "5 trends that will change how we use social media this year"
    }
  ],
  "problems": ""
}
```

### Upload an image or video

Upload an image or video from a web address to Hootsuite and wait until it's ready, for attaching to posts.

**Inputs**

- File address (`url`, text, required): Web address of a JPG, PNG or GIF image or an MP4 or MOV video, up to 512 MB.

**Outputs**

- `media` (object): An image or video uploaded to Hootsuite

**Example output**

```json
{
  "media": {
    "download_url": "https://hootsuiteapis.s3-us-east-1.amazonaws.com/2147563588/5eb2d61a",
    "id": "aHR0cHM6Ly9ob290c3VpdGUtdmlkZW8uczMuYW1hem9uYXdzLmNvbS9wcm9kdWN0aW9u",
    "mime_type": "image/png",
    "ready": true,
    "size_bytes": 48213,
    "state": "READY"
  }
}
```
