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
| Action | What it does |
|---|---|
| Approve a post | Approve a post that is waiting for your approval. |
| Check an upload | Check whether an uploaded image or video is ready to attach to a post. |
| Delete a post | Delete a scheduled post, or one waiting for approval, so it is never sent. |
| Find posts | Find posts scheduled or sent between two times (up to 4 weeks apart), optionally by state and social profile. |
| Get a member | Get a Hootsuite member's name, email, time zone and more. |
| Get a post | Get a post: its text, state, send time and, once sent, where it is live. |
| Get a post's approval history | See who created, edited, approved or rejected a post, and when. |
| Get a social profile | Get one social profile: its network, name, owner and whether it needs reconnecting in Hootsuite. |
| Get a team | Get a Hootsuite team's name and when it was created. |
| Get my account | Get the Hootsuite account Lodol is signed in as: name, email and ID. |
| List a member's social profiles | List the organization's social profiles a member can use. |
| List a member's teams | List the teams a member of your Hootsuite organization is in. |
| List a team's social profiles | List the social profiles a Hootsuite team can use. |
| List my organizations | List the Hootsuite organizations your account belongs to. |
| List organization members | List everyone in your Hootsuite organization, with names and emails. |
| List social profiles | List the social media accounts you can post to through Hootsuite, optionally from one network. |
| List team members | List the members of a Hootsuite team, with names and emails. |
| List teams | List the teams in your Hootsuite organization. |
| List teams with access to a social profile | List the Hootsuite teams that can use a social profile. |
| Reject a post | Reject a post that is waiting for your approval, telling its author why. |
| Schedule a post | Schedule a post to one or more social profiles, with images or videos if you like. |
| 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. |
Approve a post
Approve a post that is waiting for your approval.
Inputs
- Post ID
message_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 ID
media_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 ID
message_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
- From
start_timedate and time - The start of the window. Defaults to now.
- To
end_timedate and time - The end of the window, at most 4 weeks after From. Defaults to 4 weeks after From.
- State
statetext - 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_idslist - Only posts to these profiles. Leave empty for all.
- Limit
limitnumber - How many to return, 1 to 100.From 1 to 100. Default:
50. - Next page
cursortext - 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 ID
member_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 ID
message_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 ID
message_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 profile
social_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
- Team
teamtextRequired - 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 ID
member_idtext - The member's ID. Leave empty for yourself.
- Organization
organization_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 ID
member_idtext - The member's ID. Leave empty for yourself.
- Organization
organization_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
- Team
teamtextRequired - The team: pick one, or use an ID from an earlier step.
- Organization
organization_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
- Organization
organization_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
- Network
networktext - 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
- Team
teamtextRequired - The team: pick one, or use an ID from an earlier step.
- Organization
organization_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
- Organization
organization_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 profile
social_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 ID
message_idtextRequired - The post's ID, from 'Schedule a post', 'Find posts' or a trigger.
- Reason
reasontextRequired - 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
- Text
texttextRequired - What the post says.
- Social profiles
social_profile_idslistRequired - Where to post: pick one or more of your social profiles. Hootsuite makes one post for each.
- Send time
send_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 videos
medialist - 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
tagslist - Hootsuite tags to add, exactly as named in Hootsuite. Only for profiles your organization owns.
- Email me when it's sent
email_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 address
urltextRequired - 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"
}
}