typefully

name	typefully
description	Manage Typefully via CLI - me, social-sets, drafts, media, tags, queue. Use when user mentions 'typefully', 'create draft', 'schedule post', 'social media drafts', or wants to interact with the Typefully API.

typefully-cli

Setup

If typefully-cli is not found, install and build it:

bun --version || curl -fsSL https://bun.sh/install | bash
npx api2cli bundle typefully
npx api2cli link typefully

api2cli link adds ~/.local/bin to PATH automatically. The CLI is available in the next command.

Always use --json flag when calling commands programmatically.

Authentication

typefully-cli auth set "your-token"
typefully-cli auth test

Resources

me

Command	Description
typefully-cli me --json	Get current authenticated user

social-sets

Command	Description
typefully-cli social-sets list --json	List all social sets (accounts)
typefully-cli social-sets get <id> --json	Get social set details with platform accounts
typefully-cli social-sets resolve-linkedin <social-set-id> --url "https://linkedin.com/company/foo" --json	Resolve LinkedIn company URL to mention syntax

drafts

Command	Description
typefully-cli drafts list <social-set-id> --json	List all drafts
typefully-cli drafts list <social-set-id> --status scheduled --json	List scheduled drafts
typefully-cli drafts list <social-set-id> --tags marketing --json	List drafts by tag
typefully-cli drafts get <social-set-id> <draft-id> --json	Get a draft by ID
typefully-cli drafts create <social-set-id> --text "Hello!" --platform x,linkedin --json	Create a draft
typefully-cli drafts create <social-set-id> --text "Now!" --publish-at now --json	Create and publish immediately
typefully-cli drafts create <social-set-id> --text "Queued" --publish-at next-free-slot --json	Create and schedule to next slot
typefully-cli drafts create <social-set-id> --text "Later" --publish-at "2026-03-10T14:00:00Z" --json	Create and schedule at specific time
typefully-cli drafts update <social-set-id> <draft-id> --text "Updated" --json	Update draft text
typefully-cli drafts update <social-set-id> <draft-id> --publish-at now --json	Publish an existing draft
typefully-cli drafts delete <social-set-id> <draft-id> --json	Delete a draft

media

Command	Description
typefully-cli media upload <social-set-id> --file-name "photo.jpg" --json	Get presigned upload URL
typefully-cli media status <social-set-id> <media-id> --json	Check media processing status

tags

Command	Description
typefully-cli tags list <social-set-id> --json	List all tags
typefully-cli tags create <social-set-id> --name "Marketing" --json	Create a new tag

queue

Command	Description
typefully-cli queue view <social-set-id> --start 2026-03-01 --end 2026-03-31 --json	View queue slots and scheduled drafts
typefully-cli queue schedule <social-set-id> --json	Get queue schedule rules
typefully-cli queue schedule-set <social-set-id> --rules '[{"h":9,"m":0,"days":["mon","wed","fri"]}]' --json	Replace queue schedule

Global Flags

All commands support: --json, --format <text|json|csv|yaml>, --verbose, --no-color, --no-header