Connectors / Service / Hootsuite

Hootsuite is the leading social media dashboard allowing you to manage multiple networks and profiles and measure your campaign results. (updated: 1605196673004)

Hootsuite

Fully-featured online social media management app

Overview

Hootsuite is the leading social media dashboard allowing you to manage multiple networks and profiles and measure your campaign results.

Authentication

When using the Hootsuite connector, the first thing you will have to do is click on 'New Authentication' in the step editor:

add-auth

You will be given the choice of two authentication environments. Choose the 'Default OAuth2.0 App' environment. Ensure you have successfully signed into your Hootsuite account using the pop-up, otherwise operations will not be able to run correctly.

hootsuite-username_password

As of version 2.0, the Hootsuite connector now supports the Organization App custom grant authentication. In this authentication environment, the grant type is set to 'organization_app'. To authenticate with this authentication environment, again click the 'New Authentication' button in the workflow properties panel.

After naming your authentication and choosing your workspace, you can select either the 'Default' or 'Custom' OAuth2 app environment. Select 'Custom OAuth2.0 App'.

hootsuite-custom-auth

NOTE: It is a good idea to include the authentication environment within your authentication name. For example, 'My Hootsuite account [default auth environment]'

Enter your values for 'Client ID', 'Client Secret', and 'Organization ID'. To get these values, go to your Hootsuite developer portal. Select your app.

hootsuite-apps

You should see the 'REST Client ID' and 'REST Client Secret' fields.

hootsuite-get-creds

If you do not see these fields, you have not been granted API access by Hootsuite yet. You can request access from Hootsuite, or find more information on finding these credentials here. Note that the Organization ID must be for a Hootsuite Organization that has your App installed.

hootsuite-custom-auth

Available Operations

The examples below show one or two of the available connector operations in use.

Please see the Full Operations Reference at the end of this page for details on all available operations for this connector.

Example

  1. Create a new workflow with a Manual Trigger and add a Hootsuite connector.

hootsuite-new_connector
  1. Select the List social profiles operation:

hootsuite-list_social_profiles
  1. Click Run Workflow Now. Then select the Debug tab and you should be able to see a successful run of the workflow to click on and view the successful output of the workflow run:

hootsuite-output
  1. Let's try to get a specific social profile. Add a step from the Hootsuite connector, set to Get social profile. Set the Social profile ID to the ID of one of the social profiles, by using a JsonPath as shown in the example:

hootsuite-get_social_profile
  1. Click Run Workflow Now, select the Debug tab and you should be able to see the successful output with the social profile you specifically requested.

hootsuite-retrieved_profile

All Operations

Latest version:

2.0

Create message

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

Delete message

Delete a message. A message is always associated with a single social profile.

Deobfuscate member IDs

Convert obfuscated member IDs back into member IDs.

Get authenticated member

Retrieve authenticated member.

Get media upload status

Retrieve the status of a media upload to Hootsuite.

Get member

Retrieves a member.

Get message

Retrieve a specific message by ID.

Get organization member permissions

Retrieve an organization member’s permissions for the organization.

Get organization member social profile permissions

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

Get social profile

Retrieve a specific social profile by ID.

List authenticated member organizations

Retrieve the organization’s that the authenticated member is in.

List authenticated member social profiles

Retrieve the social media profiles that the authenticated user has basic usage permissions on.

List organization member social profiles

Retrieve the organization’s social profiles that an organization member can access.

List organization member teams

Retrieve the teams an organization member is in.

List organization members

Retrieve the member’s in an organization

List organization teams

Retrieve a list of teams for a given organization.

List outbound messages

Retrieve a list of outbound messages.

List scim users

Retrieve a Hootsuite team using the SCIM 2.0 protocol.

List social profiles

Retrieve a list of social profiles.

List social profiles DDL

List team members

Retrieve the members in a team.

Raw HTTP request (advanced)

Perform a raw HTTP request with some pre-configuration and processing by the connector, such as authentication.

Upload media

Upload media that can be attached to a message.