Skills Development Schedule Social Posts Via Hootsuite API

Schedule Social Posts Via Hootsuite API

v20260423
hootsuite-hello-world
This guide demonstrates core functionalities for integrating with Hootsuite using its REST API. It provides complete examples on how to list connected social profiles, schedule posts across multiple networks (Twitter, Facebook, etc.), and retrieve pending messages. It is ideal for developers starting a new social media automation tool or needing to test basic API posting patterns.
Get Skill
383 downloads
Overview

Hootsuite Hello World

Overview

List your social media profiles and schedule a post using the Hootsuite REST API. The API base URL is https://platform.hootsuite.com/v1/.

Prerequisites

  • Completed hootsuite-install-auth setup
  • Valid access token
  • At least one social profile connected in Hootsuite

Instructions

Step 1: List Social Profiles

// hello-hootsuite.ts
import 'dotenv/config';

const TOKEN = process.env.HOOTSUITE_ACCESS_TOKEN!;
const BASE = 'https://platform.hootsuite.com/v1';

async function listProfiles() {
  const response = await fetch(`${BASE}/socialProfiles`, {
    headers: { 'Authorization': `Bearer ${TOKEN}` },
  });
  const { data } = await response.json();

  for (const profile of data) {
    console.log(`${profile.type}: @${profile.socialNetworkUsername} (ID: ${profile.id})`);
  }
  return data;
}

listProfiles().catch(console.error);

Step 2: Schedule a Post

async function schedulePost(socialProfileId: string, text: string, scheduledAt: Date) {
  const response = await fetch(`${BASE}/messages`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${TOKEN}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      text,
      socialProfileIds: [socialProfileId],
      scheduledSendTime: scheduledAt.toISOString(),
      emailNotification: false,
    }),
  });

  const result = await response.json();
  console.log('Scheduled message ID:', result.data[0]?.id);
  console.log('State:', result.data[0]?.state);
  console.log('Scheduled for:', result.data[0]?.scheduledSendTime);
  return result;
}

// Schedule a post 1 hour from now
const profiles = await listProfiles();
if (profiles.length > 0) {
  const oneHourLater = new Date(Date.now() + 3600000);
  await schedulePost(profiles[0].id, 'Hello from the Hootsuite API!', oneHourLater);
}

Step 3: List Scheduled Messages

async function listMessages() {
  const response = await fetch(`${BASE}/messages?state=SCHEDULED&limit=10`, {
    headers: { 'Authorization': `Bearer ${TOKEN}` },
  });
  const { data } = await response.json();
  for (const msg of data) {
    console.log(`[${msg.state}] ${msg.text?.substring(0, 60)}... → ${msg.scheduledSendTime}`);
  }
}

Step 4: curl Quick Test

# List profiles
curl -s -H "Authorization: Bearer $HOOTSUITE_ACCESS_TOKEN" \
  https://platform.hootsuite.com/v1/socialProfiles | python3 -m json.tool

# Get current user
curl -s -H "Authorization: Bearer $HOOTSUITE_ACCESS_TOKEN" \
  https://platform.hootsuite.com/v1/me | python3 -m json.tool

Output

  • Listed social media profiles with IDs
  • Scheduled a post to a social profile
  • Retrieved scheduled messages

Error Handling

ErrorCauseSolution
401 UnauthorizedExpired tokenRefresh token via OAuth flow
403 ForbiddenInsufficient permissionsCheck app scopes
422 UnprocessableInvalid profile ID or past dateVerify profile ID and future date
No profiles returnedNo social accounts connectedConnect accounts in Hootsuite dashboard

Resources

Next Steps

Proceed to hootsuite-local-dev-loop for development workflow.

Info
Category Development
Name hootsuite-hello-world
Version v20260423
Size 3.92KB
Updated At 2026-04-28
Language