Hootsuite

The Hootsuite modules enable you to manage your social network profiles in your Hootsuite account.

Getting Started with Hootsuite

Prerequisites

  • A Hootsuite account

In order to use Hootsuite with Integromat, it is necessary to have a Hootsuite account. If you do not have one, you can create a Hootsuite account at hootsuite.com/plans.

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting Hootsuite to Integromat

To connect your Hootsuite account to Integromat follow the general instructions for Connecting to services.

After you click the Continue button, Integromat will redirect you to the Hootsuite website where you will be prompted to grant Integromat access to your account.

2019-11-05_15_12_37-https___platform.hootsuite.com_oauth2_consent_id_token_eyJhbGciOiJSUzI1NiIsInR5c.png

Confirm the dialog by clicking the Allow button.

My Account

List My Social Profiles

Returns the ID of user's social profiles in your Hootsuite account.

Connection Establish a connection to your Hootsuite account.
Limit Set the maximum number of social profiles Integromat will return during one execution cycle.

List My Organizations

Retrieves all organizations in your account.

Connection Establish a connection to your Hootsuite account.
Limit Set the maximum number of organizations Integromat will return during one execution cycle.

Social Profiles

Retrieves the social profiles that you have access to.

Connection Establish a connection to your Hootsuite account.
Limit Set the maximum number of social profiles Integromat will return during one execution cycle.

Get a Social Profile

Retrieves social profile details.

Connection Establish a connection to your Hootsuite account.
Social Profile Enter (map) the ID or select the social profile you want to retrieve details about.

List Social Profile Teams

Retrieves a list of Team IDs with access to a social profile.

Connection Establish a connection to your Hootsuite account.
Social Profile Enter (map) the ID or select the social profile you want to list teams from.
Limit Set the maximum number of teams Integromat will return during one execution cycle.

Messages

Watch Messages

Triggers when a message status has been changed.

The module is triggered only when the message state is changed using the API. It does not trigger on message events performed in the Hootsuite web UI.
You must provide the webhook URL (generated by this Watch Messages module) to the Schedule a Message module (Show advanced settings - Webhook URLs field) in order to trigger this webhook. It can be done in a separate scenario.
Webhook name Enter the name for the webhook. E.g. Sent Twitter Message
Connection Establish a connection to your Hootsuite account.

After you add the webhook to the scenario, copy the webhook URL and insert it to the corresponding field in the Schedule a Message module.

2020-01-09_13_21_26-Integration_Hootsuite___Integromat.png

2020-01-09_13_28_24-Integration_Hootsuite___Integromat.png

List Outbound Messages

Retrieves messages that are scheduled or were previously sent. Messages pending approval, including those created by and/or actionable by the given user, will also be returned by this module.

Connection Establish a connection to your Hootsuite account.
Start time Enter the start date range of messages to be returned in ISO-8601 format. E.g. 2020-01-01T00:00:00Z
End time Enter the start date range of messages to be returned in ISO-8601 format. E.g. 2020-01-01T00:00:00Z. Must not be later than 4 weeks from Start Time.
Filter by State Select the state of returned messages.
Filter by Social Profile IDs Select social profiles you want to return outbound messages for.
Include Unscheduled Review Messages Select Yes to retrieve unscheduled (Send Now) review messages on top of scheduled ones retrieved from time range query.
Limit Set the maximum number of messages Integromat will return during one execution cycle.

Schedule a Message

Schedules a message to send on one or more social profiles (except Pinterest).

Connection Establish a connection to your Hootsuite account.
Social Profile IDs

Select social profiles that the message will be posted to.

Scheduling a message to Pinterest can not be bundled with any other social profiles.
Message Text Enter the message text you want to publish.
Message Scheduled Send Time

Enter the time the message is scheduled to be sent in UTC time, ISO-8601 format. Missing or different timezones will not be accepted, to ensure there is no ambiguity about scheduled time. Dates must end with 'Z' to be accepted. E.g.  2020-01-01T00:00:00Z.

The send time must be at least 5 minutes in the future. For videos, it must be 15 minutes in the future. For larger videos, an hour is recommended.

Message Media

Add the media you want to attach to the message.

  • ID
    Enter (map) the ID of the media you want to attach to the message.
    The ID can be retrieved using the Upload a Media module.
    2020-01-09_16_10_03-Integration_Hootsuite___Integromat.png
  • Title
    Facebook video metadata. Enter the title for the video.
  • Category
    Facebook video metadata. Select the video category.
Ow.ly Media URLs The ow.ly media to attach to the message.
Pinterest Specific Fields

Add information needed for Pinterest messages.

  • Social Profile Type
    The social profile type. Leave "PINTEREST value".
  • Social Profile ID
    Use the List Social Profiles module to retrieve your Pinterest Social Profile ID. Required for Pinterest posts.
  • Board ID
    There are two ways this field can be filled. Either use the Board ID or the Board Reference. The Board reference can be constructed as followed: <username>/<board name>. For example: john/my-great-board. Alternatively the Board ID can be used, however, Hootsuite does not provide a way to get Board IDs. Required for Pinterest posts.
  • Destination URL
    The URL the pin links to. Required for Pinterest posts.
Tags

Add Tags to be applied to the message. The social media profile must belong to an organization. Tags are case sensitive. Limited permission members can only use the existing tags for the organization and cannot create new ones. Not supported by Pinterest.

Email Notification

Select the Yes option to send an email notification when the message is published.

Webhooks URLs

Add the webhook URL generated by the Watch Messages module to trigger the webhook when the message status is changed (SENT, SCHEDULED, etc).

Location Options

The message’s geolocation in decimal degrees for latitude and longitude. Twitter allows users to set the location for a post manually. Not supported by Pinterest.

  • Latitude
    Enter the latitude in decimal degrees. Must be between -90 to 90.
  • Longitude
    The longitude in decimal degrees. Must be between -180 to 180.
Privacy Options

Facebook/LinkedIn visibility
Select who can see your post. Max 1 option can be selected.

Targeting Options - Facebook

Specify social network targeting options to be applied when publishing the message.

Age Minimum
Select the minimum age the message is being targeted towards. 
Education

Select the education level the message is being targeted towards.

Interested In

Interested in preferences the message is being targeted towards

Relationship Status

Select the relationship status the message is being targeted towards.

Countries
Select the country the message is being targeted towards. 
  • Full Country Name
    Enter the full name of the country being targeted.
  • 2-Digit ISO 3166 Country Key
    Enter the 2-digit ISO 3166 format code, as provided by Facebook.
Regions
Region the message is being targeted towards. Note that regions can only be specified when there is exactly one country targeted. Limit 200.

 

 Cities
City the message is being targeted towards. Note that cities can only be specified when there is exactly one country targeted. Limit 250.
 Zips

Zip/Postal Code the message is being targeted towards. Limit 50,000.

Targeting Options - LinkedIn

Specify social network targeting options to be applied when publishing the message.

Target Company Sizes
Select the company size the message is being targeted towards.
Target Geographies Add the geographies the message is being targeted towards by entering the geography code.
Target Industries Add the industries the message is being targeted towards by entering the industry code.
Target Job Functions

Add the job functions the message is being targeted towards by entering the job function code.

Target Seniorities Add the job functions the message is being targeted towards by entering the seniority code.

Get a Message

Retrieves a message associated with a single social profile.
Messages might be unavailable for a brief time during upload to social networks.

Connection Establish a connection to your Hootsuite account.
Message ID Enter (map) the ID or select the message you want to retrieve details about.

Delete a Message

Deletes a scheduled message.

Connection Establish a connection to your Hootsuite account.
Message ID Enter (map) the ID or select the message you want to delete.

Organizations

List Organization Members

Retrieves IDs of members of an organization.

Connection Establish a connection to your Hootsuite account.
Organization ID Enter (map) the ID or select the organization you want to retrieve members from. 

Get an Organization Member

Retrieves member details.

Connection Establish a connection to your Hootsuite account.
Organization ID Switch to the selecting mode using the map button (mceclip0.png) to select the organization from the drop-down menu.
Member ID Enter (map) or select the ID of the member you want to retrieve details about.

Create an Organization Member

Invites a member to a Hootsuite organization. 

Requires organization manage members permission.
Connection Establish a connection to your Hootsuite account.
Member Full Name Enter the name of the member you want to create.
Member Email Enter the member's email address.
Array of Organization IDs Select the organization you want to add the user to.
Company Name Enter the member’s company name.
Bio Enter the member’s bio.
Timezone The member's time zone. If not provided it will default to “America/Vancouver”. Valid values are defined at http://php.net/manual/en/timezones.php.

Remove an Organization Member

Removes a member from an organization.

Connection Establish a connection to your Hootsuite account.
Organization ID Switch to the selecting mode using the map button (mceclip0.png) to select the organization from the drop-down menu or enter (map) the Organization ID.
Member ID Enter (map) or select the ID of the member you want to remove from the organization.

List Member's Teams

Retrieves the teams an organization member is in.

Connection Establish a connection to your Hootsuite account.
Organization ID Switch to the selecting mode using the map button (mceclip0.png) to select the organization from the drop-down menu or enter (map) the Organization ID.
Member ID Enter (map) or select the ID of the member whose teams you want to retrieve.
Limit Set the maximum number of teams Integromat will return during one execution cycle.

List Member's Organizations

Retrieves the organizations a member is in.

Connection Establish a connection to your Hootsuite account.
Organization ID Switch to the selecting mode using the map button (mceclip0.png) to select the organization from the drop-down menu or enter (map) the Organization ID.
Member ID Enter (map) or select the ID of the member whose organizations you want to retrieve.
Limit Set the maximum number of organizations Integromat will return during one execution cycle.

Get Member's Organization Permissions

Retrieves an organization member’s permissions for the organization.

Connection Establish a connection to your Hootsuite account.
Organization ID Switch to the selecting mode using the map button (mceclip0.png) to select the organization from the drop-down menu or enter (map) the Organization ID.
Member ID Enter (map) or select the ID of the member whose permissions for the organizations you want to retrieve.
Limit Set the maximum number of member's permissions Integromat will return during one execution cycle.

 

List Member's Social Profiles

Retrieves the organization's social profiles that a member can access.

Connection Establish a connection to your Hootsuite account.
Organization ID Switch to the selecting mode using the map button (mceclip0.png) to select the organization from the drop-down menu or enter (map) the Organization ID.
Member ID Enter (map) or select the ID of the member whose social profiles you want to retrieve.
Limit Set the maximum number of social profiles Integromat will return during one execution cycle.

Get Member's Social Profile Permissions

Retrieves an organization member’s permissions for a social profile.

Connection Establish a connection to your Hootsuite account.
Organization ID Switch to the selecting mode using the map button (mceclip0.png) to select the organization from the drop-down menu or enter (map) the Organization ID.
Member ID Enter (map) or select the ID of the member whose social profiles permissions you want to retrieve.
Social Profile ID

Enter (map) or select the ID of the social profile you want to retrieve member's permissions for.

Teams

List Organization Teams

Retrieves a list of teams for a given organization.

Connection Establish a connection to your Hootsuite account.
Organization ID Switch to the selecting mode using the map button (mceclip0.png) to select the organization from the drop-down menu or enter (map) the Organization ID.
Limit Set the maximum number of teams Integromat will return during one execution cycle.

Get a Team

Retrieves team details.

Connection Establish a connection to your Hootsuite account.
Organization ID Switch to the selecting mode using the map button (mceclip0.png) to select the organization from the drop-down menu or enter (map) the ID of the organization you want to retrieve details about.
Team ID Enter (map) or select the team you want to retrieve details about.

Create a Team

Creates a team in an organization.

Connection Establish a connection to your Hootsuite account.
Organization ID Switch to the selecting mode using the map button (mceclip0.png) to select the organization from the drop-down menu or enter (map) the ID of the organization.
Team Name Enter the name for the new team.

List Team's Social Profiles

Retrieves the organization's social profiles that a team can access.

Connection Establish a connection to your Hootsuite account.
Organization ID Switch to the selecting mode using the map button (mceclip0.png) to select the organization from the drop-down menu or enter (map) the organization ID.
Team ID Enter (map) or select the team you want to retrieve the social profiles for.
Limit Set the maximum number of social profiles Integromat will return during one execution cycle.

List Team Members

Retrieves members of a team.

Connection Establish a connection to your Hootsuite account.
Organization ID Switch to the selecting mode using the map button (mceclip0.png) to select the organization from the drop-down menu or enter (map) the Organization ID.
Team ID Enter (map) or select the team you want to retrieve members from.
Limit Set the maximum number of members Integromat will return during one execution cycle.

Get a Team Member's Permission

Retrieves team member's permissions.

Connection Establish a connection to your Hootsuite account.
Organization ID Switch to the selecting mode using the map button (mceclip0.png) to select the organization from the drop-down menu or enter (map) the Organization ID.
Team ID Enter (map) or select the ID of the team you want to retrieve member's permissions for.
Member ID Enter (map) or select the ID of the member whose permissions for the team you want to retrieve.

Add a Member to a Team

Adds a member to a team.

Connection Establish a connection to your Hootsuite account.
Organization ID Switch to the selecting mode using the map button (mceclip0.png) to select the organization from the drop-down menu or enter (map) the Organization ID.
Team ID Enter (map) or select the ID of the team you want to add a member to.
Member ID Enter (map) or select the ID of the member that you want to add to the team.

Media

Upload a Media

Uploads a media file to an Amazon S3 upload URL. The module provides the Media ID when the file is successfully uploaded. The Media ID can be used to attach the uploaded file to the scheduled message using the Schedule a Message module.

Add the Get a Media's Upload Status module to the scenario after Upload a Media module to ensure that the file is uploaded successfully with the state: READY.

The example of attaching a file to the scheduled message:

2020-01-14_12_43_52-Window.png

Added filter under label "Status":

2020-01-14_12_45_11-Window.png

Connection Establish a connection to your Hootsuite account.
Source File

Map the file you want to upload from the previous module (e.g. HTTP > Get a File or Dropbox > Get a file), or enter the file name and file data manually.

2020-01-14_10_39_22-Window.png

Get a Media's Upload Status

Retrieves the status of a media upload to Hootsuite.

Connection Establish a connection to your Hootsuite account.
Media ID

Enter (map) the Media ID of the file you have uploaded.

Use it after the Upload a Media module.

Other

Make an API Call

Allows you to perform a custom API call.

Connection Establish a connection to your Hootsuite account.
URL

Enter a path relative to https://platform.hootsuite.com. For example: /v1/messages/5714020253

For the list of available endpoints, refer to the Hootsuite REST API documentation.
Method

Select the HTTP method you want to use:

GET
to retrieve information for an entry.

POST
to create a new entry.

PUT
to update/replace an existing entry.

PATCH
to make a partial entry update.

DELETE
to delete an entry.

Headers Enter the desired request headers. You don't have to add authorization headers; we already did that for you.
Query String Enter the request query string.
Body Enter the body content for your API call.

Example of Use - List Organization Members

The following API call returns the members from the specified organization in your Hootsuite account.

URL:
/v1/organizations/885558/members

Method:

GET

2020-01-14_13_13_25-Window.png

Matches of the search can be found in the module's Output under Bundle > Body > data
In our example,  3 members were returned:

2020-01-14_13_17_56-Window.png

Popular use cases from our blog

slack-automation-illustration

Slack Automation: 20 Free Templates to Get You Inspired

google-sheets-automation-alt

Google Sheets Automation for Ecommerce: 23 Free Templates

tweet-automation-illustration

How to Get Someone's Tweets Before Anyone Else Does

onboarding-automation-with-integromat-alt

How to Automate Employee Onboarding in Minutes with Integromat

shopify-order-to-manufacturer-illustration-alt

How to Auto Send Shopify Orders to Dropshipping Suppliers [Guide]

strava-exercise-to-google-sheets-illustration

Like a Champ: How to Save Strava Activities to Google Sheets

Didn’t find what you were looking for?

Ticket

Create a ticket

Contact our world-class support team and tell us what’s happening.

Create a ticket
Expert

Find an expert

We feature a network of 450+ certified partners across the globe who are ready to help

Find an expert

Automate any workflow in your business

Sign up for a free account today. No credit card required, no time limits on free plan.