| 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
