> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mallary.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Sign in once with OAuth, check your Mallary account, and get ready to publish.

## Sign In

```bash theme={null}
mallary auth login
mallary auth status
```

Open the Mallary URL shown by the CLI and enter the one-time code. One OAuth login gives access to view data, publish posts, reply to comments, and manage settings and connections. Users do not choose scopes. The setup checks below do not post or change anything. Later, a clear request to publish, schedule, upload media for a requested post, or send a supplied reply is enough authorization; the agent should not ask for a second confirmation.

## Health Check

```bash theme={null}
mallary health
```

## Upload Local Media

```bash theme={null}
mallary upload ./launch.mp4
```

## Create a Post

```bash theme={null}
mallary posts create \
  --message "Check out my new product video!" \
  --platform facebook \
  --platform instagram \
  --post-type story \
  --profile-id AbC123xYz90 \
  --media ./launch.mp4 \
  --thumbnail ./launch-cover.jpg
```

## List Posts

```bash theme={null}
mallary posts list
```

## Read a Job

```bash theme={null}
mallary jobs get 123
```

After publishing, job output includes `platform_post_id` and `platform_post_url` when the platform returns or exposes them.

## List Connected Platforms

```bash theme={null}
mallary platforms list
```

This read-only command also returns each platform's selectable `post_types`, such as `story` for Facebook and Instagram.

## List Your Profiles within Mallary

Profiles group your social media accounts. Create one profile for each of your businesses. Then connect the social media accounts of that business inside its profile. If you do not send a `profile_id`, Mallary uses your default profile.

Each profile has a random public ID, such as AbC123xYz90. Use that ID as `profile_id` in API, MCP, and CLI requests.

Omit `profile_id` on publishing and reporting endpoints to use the default profile. Send `profile_id` when you want to target a non-default profile.

```bash theme={null}
mallary profiles list
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.