# Social

URL: https://docs.hanzo.ai/docs/cli/social

> The `hanzo social` commands.

Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/social) · **CLI** · [MCP](https://docs.hanzo.ai/docs/mcp-tools/social) · [SDKs](https://docs.hanzo.ai/docs/sdks)

Posting to every social account you own, now or on a schedule.

[API reference →](https://docs.hanzo.ai/docs/openapi/social)

```bash
hanzo social posts list
```

Every command takes `--json` for the raw response and `--help` for its own flags. Sign in once with `hanzo auth login`; the commands below use that session, and the org they act in is the one it carries.

| Command                  | What it does                                                                                                                                                                                       |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo social providers` | Reports each supported network's publish-readiness: whether this deployment holds the OAuth application credentials for it and, when it does not, exactly which environment variables are missing. |
| `hanzo social summary`   | Returns four counts for the caller's org: total posts, how many are scheduled, how many have published, and how many accounts are connected.                                                       |

### Accounts

| Command                          | What it does                                                                                                                    |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `hanzo social accounts create`   | Records a social account for the org and answers 201 with the stored row, including the generated id later calls address it by. |
| `hanzo social accounts get <id>` | Returns one of the org's connected accounts by id — its network, handle, status and timestamps — or 404.                        |
| `hanzo social accounts list`     | Returns the org's connected accounts — each one's id, network, handle, status and timestamps, most-recently-updated first.      |
| `hanzo social accounts rm <id>`  | Removes one connected account from the org and answers 204 with no body; an id that is not there is 404.                        |
| `hanzo social accounts set <id>` | Replaces the account's network, handle and status with what the body carries, and answers with the stored row.                  |

### Posts

| Command                           | What it does                                                                                                                                                       |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `hanzo social posts create`       | Stores a post for the org and answers 201 with the stored row.                                                                                                     |
| `hanzo social posts get <id>`     | Returns one of the org's posts by id, with its current status, scheduled time, media and — once it has published — the account and external id it published under. |
| `hanzo social posts list`         | Returns the org's posts — content, channel, status, scheduled time, media and timestamps — most-recently-updated first.                                            |
| `hanzo social posts publish <id>` | Publishes the post immediately to the connected accounts on its channel and answers with the updated row, carrying the account and external id it published under. |
| `hanzo social posts rm <id>`      | Removes one post from the org and answers 204 with no body; an id that is not there is 404.                                                                        |
| `hanzo social posts set <id>`     | Replaces the post's content, channel, status, scheduled time and media with what the body carries, and answers with the stored row.                                |