Hootsuite

App · 22 actions

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.

Actions

ActionWhat it does
Approve a postApprove a post that is waiting for your approval.
Check an uploadCheck whether an uploaded image or video is ready to attach to a post.
Delete a postDelete a scheduled post, or one waiting for approval, so it is never sent.
Find postsFind posts scheduled or sent between two times (up to 4 weeks apart), optionally by state and social profile.
Get a memberGet a Hootsuite member's name, email, time zone and more.
Get a postGet a post: its text, state, send time and, once sent, where it is live.
Get a post's approval historySee who created, edited, approved or rejected a post, and when.
Get a social profileGet one social profile: its network, name, owner and whether it needs reconnecting in Hootsuite.
Get a teamGet a Hootsuite team's name and when it was created.
Get my accountGet the Hootsuite account Lodol is signed in as: name, email and ID.
List a member's social profilesList the organization's social profiles a member can use.
List a member's teamsList the teams a member of your Hootsuite organization is in.
List a team's social profilesList the social profiles a Hootsuite team can use.
List my organizationsList the Hootsuite organizations your account belongs to.
List organization membersList everyone in your Hootsuite organization, with names and emails.
List social profilesList the social media accounts you can post to through Hootsuite, optionally from one network.
List team membersList the members of a Hootsuite team, with names and emails.
List teamsList the teams in your Hootsuite organization.
List teams with access to a social profileList the Hootsuite teams that can use a social profile.
Reject a postReject a post that is waiting for your approval, telling its author why.
Schedule a postSchedule a post to one or more social profiles, with images or videos if you like.
Upload an image or videoUpload an image or video from a web address to Hootsuite and wait until it's ready, for attaching to posts.

Approve a post

Approve a post that is waiting for your approval.

Inputs

Post IDmessage_idtextRequired
The post's ID, from 'Schedule a post', 'Find posts' or a trigger.

Outputs

approvedtrue/false
True once approved
messageobject
A post to one social profile
message_idtext
The post's ID
Example output
{
  "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 IDmedia_idtextRequired
The media ID from 'Upload an image or video'.

Outputs

mediaobject
An image or video uploaded to Hootsuite
Example output
{
  "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 IDmessage_idtextRequired
The post's ID, from 'Schedule a post', 'Find posts' or a trigger.

Outputs

deletedtrue/false
True once deleted
message_idtext
The deleted post's ID
Example output
{
  "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

Fromstart_timedate and time
The start of the window. Defaults to now.
Toend_timedate and time
The end of the window, at most 4 weeks after From. Defaults to 4 weeks after From.
Statestatetext
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 profilessocial_profile_idslist
Only posts to these profiles. Leave empty for all.
Limitlimitnumber
How many to return, 1 to 100.From 1 to 100. Default: 50.
Next pagecursortext
The next_page value an earlier step returned, to get the page after it.

Outputs

countnumber
How many there are
end_timetext
The window's end (UTC)
messageslist
The posts, earliest first
next_pagetext
Pass as Next page for more; empty when there are no more
start_timetext
The window's start (UTC)
Example output
{
  "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 IDmember_idtextRequired
The member's ID, from another Hootsuite step.

Outputs

memberobject
A Hootsuite member (a person with a Hootsuite login)
Example output
{
  "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 IDmessage_idtextRequired
The post's ID, from 'Schedule a post', 'Find posts' or a trigger.

Outputs

messageobject
A post to one social profile
Example output
{
  "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 IDmessage_idtextRequired
The post's ID, from 'Schedule a post', 'Find posts' or a trigger.

Outputs

actionslist
What happened, in order
countnumber
How many there are
message_idtext
The post's ID
Example output
{
  "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 profilesocial_profile_idtextRequired
The social profile: pick one, or use an ID from an earlier step.

Outputs

social_profileobject
A social profile: one account on a social network that Hootsuite posts to
Example output
{
  "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

TeamteamtextRequired
The team: pick one, or use an ID from an earlier step.

Outputs

teamobject
A team in a Hootsuite organization
Example output
{
  "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

memberobject
A Hootsuite member (a person with a Hootsuite login)
Example output
{
  "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 IDmember_idtext
The member's ID. Leave empty for yourself.
Organizationorganization_idtext
The Hootsuite organization. Leave empty to use yours (the first, if you're in several).

Outputs

countnumber
How many there are
member_idtext
The member's ID
social_profileslist
The social profiles
Example output
{
  "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 IDmember_idtext
The member's ID. Leave empty for yourself.
Organizationorganization_idtext
The Hootsuite organization. Leave empty to use yours (the first, if you're in several).

Outputs

countnumber
How many there are
member_idtext
The member's ID
teamslist
The teams
Example output
{
  "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

TeamteamtextRequired
The team: pick one, or use an ID from an earlier step.
Organizationorganization_idtext
The Hootsuite organization. Leave empty to use yours (the first, if you're in several).

Outputs

countnumber
How many there are
social_profileslist
The social profiles
team_idtext
The team's ID
Example output
{
  "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

countnumber
How many there are
organizationslist
The organizations
Example output
{
  "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

Organizationorganization_idtext
The Hootsuite organization. Leave empty to use yours (the first, if you're in several).

Outputs

countnumber
How many there are
memberslist
The members
organization_idtext
The organization's ID
Example output
{
  "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

Networknetworktext
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

countnumber
How many there are
social_profileslist
The social profiles
Example output
{
  "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

TeamteamtextRequired
The team: pick one, or use an ID from an earlier step.
Organizationorganization_idtext
The Hootsuite organization. Leave empty to use yours (the first, if you're in several).

Outputs

countnumber
How many there are
memberslist
The members
team_idtext
The team's ID
Example output
{
  "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

Organizationorganization_idtext
The Hootsuite organization. Leave empty to use yours (the first, if you're in several).

Outputs

countnumber
How many there are
organization_idtext
The organization's ID
teamslist
The teams
Example output
{
  "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 profilesocial_profile_idtextRequired
The social profile: pick one, or use an ID from an earlier step.

Outputs

countnumber
How many there are
teamslist
The teams
Example output
{
  "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 IDmessage_idtextRequired
The post's ID, from 'Schedule a post', 'Find posts' or a trigger.
ReasonreasontextRequired
Why it's rejected. Hootsuite shows this to the post's author.

Outputs

messageobject
A post to one social profile
message_idtext
The post's ID
rejectedtrue/false
True once rejected
Example output
{
  "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

TexttexttextRequired
What the post says.
Social profilessocial_profile_idslistRequired
Where to post: pick one or more of your social profiles. Hootsuite makes one post for each.
Send timesend_timedate 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 videosmedialist
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.
Tagstagslist
Hootsuite tags to add, exactly as named in Hootsuite. Only for profiles your organization owns.
Email me when it's sentemail_notificationtrue/false
Have Hootsuite email you when the post goes out.Default: false.

Outputs

countnumber
How many there are
message_idtext
ID of the first post made (one is made per profile)
messageslist
One post per social profile
problemstext
What Hootsuite refused, if it refused some profiles
Example output
{
  "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 addressurltextRequired
Web address of a JPG, PNG or GIF image or an MP4 or MOV video, up to 512 MB.

Outputs

mediaobject
An image or video uploaded to Hootsuite
Example output
{
  "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"
  }
}

On this page