Agent skill · data analytics · jeremylongshore
hootsuite-common-errors
Diagnose and fix Hootsuite common errors and exceptions.
Why this skill is useful
Provides specific troubleshooting commands and error handling patterns for the Hootsuite API that the AI wouldn't reliably generate on its own.
What it needs
Requires bash installed locally. Requires hootsuite account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Hootsuite Common Errors Error Reference 401 Unauthorized Cause: Access token expired (tokens last ~1 hour). Fix: Refresh token via OAuth: 403 Forbidden Cause: App lacks required permissions or user doesn't own the resource. Fix: Check app scopes in developer portal. Ensure user has access to the social profile. 422 Unprocessable Entity — scheduledSendTime Cause: Scheduled time is in the past or invalid ISO 8601 format. Fix: Always use future dates in ISO 8601: new Date(Date.now() + 3600000).toISOString() 422 — socialProfileIds Cause: Profile ID invalid or disconnected. Fix: List profiles first: GET /v1/socialProfiles and verify IDs. 429 Too Many Requests Cause: Rate limit exceeded. Fix: Implement exponential backoff. See hootsuite-rate-limits. Media Upload — State REJECTED Cause: File too large, wrong format, or exceeds platform limits. Fix: Check per-platform limits: Twitter images 5MB, Facebook 10MB, video varies. invalidgrant — Token Exchange Cause: Authorization code expired (30 second lifetime) or already used. Fix: Re-initiate OAuth flow — codes are single-use and expire in 30s. redirecturimismatch Cause: Redirect URI doesn't exactly match app registration. Fix: Must match character-for-character, including trailing slash. Quick Diagnostics Overview This reference triages profile, schedule, approval, audience, and quota failures through redacted status and opaque IDs. It does not authorize copying post content, media, handles, or account metadata into a ticket. Prerequisites A draft-only sandbox probe, redacted correlation ID, endpoint class, and HTTP or terminal schedule status. A scoped read-only diagnostic credential and named owner for account, audience, or approval changes. Instructions 1. Classify authentication, authorization, profile lookup, approval, audience, validation, quota, and schedule errors before changes. 2. Reproduce once with the draft-only fixture, capturing only status, latency, quota, and opaque IDs. 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/hootsuite-common-errors