Active |
---|
This application does not need additional settings. So you can make connectionUnique, active service acces point to a network. There are different types of connections (API key, Oauth…). More only by using your login credentials or by following the instructions below . |
The Hootsuite modulesThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More enable you to manage your social network profiles in your Hootsuite account.
Prerequisites
-
A Hootsuite account
In order to use Hootsuite with Boost.spaceCentralization and synchronization platform, where you can organize and manage your data. More IntegratorPart of the Boost.space system, where you can create your connections and automate your processes. More, it is necessary to have a Hootsuite account. If you do not have one, you can create a Hootsuite account at hootsuite.com/plans.
Note | |
---|---|
The moduleThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More dialog fields that are displayed in bold (in the Boost.space Integrator scenarioA specific connection between applications in which data can be transferred. Two types of scenarios: active/inactive. More, not in this documentation article) are mandatory! |
To connect your Hootsuite account to Boost.space Integrator follow the general instructions for Connecting to services.
After you click the Continue button, Boost.space Integrator will redirect you to the Hootsuite website where you will be prompted to grant Boost.space Integrator access to your account.
Confirm the dialog by clicking the Allow button.
Returns the ID of user’s social profiles in your Hootsuite account.
Connection |
|
Limit |
Set the maximum number of social profiles Boost.space Integrator will return during one execution cycleA cycle is the operation and commit/rollback phases of scenario execution. A scenario may have one or more cycles (one is the default).. |
Retrieves all organizations in your account.
Connection |
|
Limit |
Set the maximum number of organizations Boost.space Integrator will return during one execution cycle. |
Retrieves the social profiles that you have access to.
Connection |
|
Limit |
Set the maximum number of social profiles Boost.space Integrator will return during one execution cycle. |
Retrieves social profile details.
Connection |
|
Social Profile |
Enter (map) the ID or select the social profile you want to retrieve details about. |
Retrieves a list of Team IDs with access to a social profile.
Connection |
|
Social Profile |
Enter (map) the ID or select the social profile you want to list teams from. |
Limit |
Set the maximum number of teams Boost.space Integrator will return during one execution cycle. |
TriggersEvery scenario has a trigger, an event that starts your scenario. A scenario must have a trigger. There can only be one trigger for each scenario. When you create a new scenario, the first module you choose is your trigger for that scenario. Create a trigger by clicking on the empty module of a newly created scenario or moving the... when a message statusCreate statuses for each module separately to create an ideal environment for efficient and consistent work. More has been changed.
Note | |
---|---|
The module is triggered only when the message state is changed using the API. It does not triggerEvery scenario has a trigger, an event that starts your scenario. A scenario must have a trigger. There can only be one trigger for each scenario. When you create a new scenario, the first module you choose is your trigger for that scenario. Create a trigger by clicking on the empty module of a newly created scenario or moving the... on message events performed in the Hootsuite web UI. |
Note | |
---|---|
You must provide the webhookA webhook is a way for an app to send real-time information to a specific URL in response to certain events or triggers. 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 |
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.
Retrieves messages that are scheduled or were previously sent. Messages pending approval, including those created by and/or actionable by the given userCan use the system on a limited basis based on the rights assigned by the admin. More, will also be returned by this module.
Connection |
|
Start time |
Enter the start date range of messages to be returned in ISO-8601 format. E.g. |
End time |
Enter the start date range of messages to be returned in ISO-8601 format. E.g. |
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 Yesto retrieve unscheduled (Send Now) review messages on top of scheduled ones retrieved from time range query. |
Limit |
Set the maximum number of messages Boost.space Integrator will return during one execution cycle. |
Schedules a message to send on one or more social profiles (except Pinterest).
Connection |
|||||||||||||||||
Social Profile IDs |
Select social profiles that the message will be posted to.
|
||||||||||||||||
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. 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.
|
||||||||||||||||
Ow.ly Media URLs |
The ow.ly media to attach to the message. |
||||||||||||||||
Pinterest Specific Fields |
Add information needed for Pinterest messages.
|
||||||||||||||||
Tags |
Add Tags to be applied to the message. The social media profile must belong to an organization. Tags are case sensitive. Limited permission membersCan view and manage items while using existing statuses and labels. More 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. |
||||||||||||||||
WebhooksA webhook is a way for an app to send real-time information to a specific URL in response to certain events or triggers. 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 usersCan use the system on a limited basis based on the rights assigned by the admin. More to set the location for a post manually. Not supported by Pinterest.
|
||||||||||||||||
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.
|
||||||||||||||||
Targeting Options – LinkedIn |
Specify social network targeting options to be applied when publishing the message.
|
Retrieves a message associated with a single social profile. Messages might be unavailable for a brief time during upload to social networks.
Connection |
|
Message ID |
Enter (map) the ID or select the message you want to retrieve details about. |
Deletes a scheduled message.
Connection |
|
Message ID |
Enter (map) the ID or select the message you want to delete. |
Retrieves IDs of members of an organization.
Connection |
|
Organization ID |
Enter (map) the ID or select the organization you want to retrieve members from. |
Retrieves memberCan view and manage items while using existing statuses and labels. More details.
Connection |
|
Organization ID |
Switch to the selecting mode using the map button () 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. |
Invites a member to a Hootsuite organization.
Note | |
---|---|
Requires organization manage members permission. |
Connection |
|
Member Full Name |
Enter the name of the member you want to create. |
Member Email |
Enter the member’s email address. |
ArrayWithin a bundle, data items of the same type are sometimes in an array. You can find an array by looking at the details of a bundle. Depending on the details of your scenario, you can map other modules to a specific item in an array or use iterators and aggregators to manipulate your data into other formats. When mapping,... More 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. |
Removes a member from an organization.
Connection |
|
Organization ID |
Switch to the selecting mode using the map button () 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. |
Retrieves the teams an organization member is in.
Connection |
|
Organization ID |
Switch to the selecting mode using the map button () 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 Boost.space Integrator will return during one execution cycle. |
Retrieves the organizations a member is in.
Connection |
|
Organization ID |
Switch to the selecting mode using the map button () 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 Boost.space Integrator will return during one execution cycle. |
Retrieves an organization member’s permissions for the organization.
Connection |
|
Organization ID |
Switch to the selecting mode using the map button () 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 Boost.space Integrator will return during one execution cycle. |
Retrieves the organization’s social profiles that a member can access.
Connection |
|
Organization ID |
Switch to the selecting mode using the map button () 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 Boost.space Integrator will return during one execution cycle. |
Retrieves an organization member’s permissions for a social profile.
Connection |
|
Organization ID |
Switch to the selecting mode using the map button () 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. |
Retrieves a list of teams for a given organization.
Connection |
|
Organization ID |
Switch to the selecting mode using the map button () to select the organization from the drop-down menu or enter (map) the Organization ID. |
Limit |
Set the maximum number of teams Boost.space Integrator will return during one execution cycle. |
Retrieves team details.
Connection |
|
Organization ID |
Switch to the selecting mode using the map button () 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. |
Creates a team in an organization.
Connection |
|
Organization ID |
Switch to the selecting mode using the map button () 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. |
Retrieves the organization’s social profiles that a team can access.
Connection |
|
Organization ID |
Switch to the selecting mode using the map button () 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 Boost.space Integrator will return during one execution cycle. |
Retrieves members of a team.
Connection |
|
Organization ID |
Switch to the selecting mode using the map button () 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 Boost.space Integrator will return during one execution cycle. |
Retrieves team member’s permissions.
Connection |
|
Organization ID |
Switch to the selecting mode using the map button () 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. |
Adds a member to a team.
Connection |
|
Organization ID |
Switch to the selecting mode using the map button () 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. |
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:
Added filter under labelA label is a “tag” that can be added to items within a module. It's a flexible tool used to categorize and organize data, making it easier to customize workflows and processes. More “Status”:
Connection |
|
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. |
Retrieves the status of a media upload to Hootsuite.
Connection |
|
Media ID |
Enter (map) the Media ID of the file you have uploaded. Use it after the Upload a Media module. |
Allows you to perform a custom API call.
Connection |
||||
URL |
Enter a path relative to
|
|||
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. |
The following API call returns the members from the specified organization in your Hootsuite account.
URL:
/v1/organizations/885558/members
Method:
GET
Matches of the search can be found in the module’s Output under BundleA bundle is a chunk of data and the basic unit for use with modules. A bundle consists of items, similar to how a bag may contain separate, individual items. More > Body > data.
In our example, 3 members were returned: