# Pozy documentation

One API to publish, message, advertise and measure across every major platform. Start with the quickstart, or jump to the part you need.

Pozy gives you one REST API, one dashboard and one AI agent surface for the platforms your users already live on. You connect an account once, then post to it, read its analytics, answer its DMs and run its ads with the same request shape everywhere.

Everything in the dashboard runs on the same public API you call. If you can do it in the app, you can do it with a request.

## Start here

- [Quickstart](https://pozy.ai/docs/getting-started/quickstart): Create a key, connect an account, publish your first post and receive your first webhook. About ten minutes.
- [Core concepts](https://pozy.ai/docs/getting-started/concepts): Workspaces, profiles, accounts and posts, and how they fit together.
- [Authentication](https://pozy.ai/docs/getting-started/authentication): API keys, read-only keys, profile scopes and disabled resource groups.
- [API reference](https://pozy.ai/docs/api): Every endpoint, with parameters, schemas and examples in cURL, Node and Python.

## What you can build

- [Publishing](https://pozy.ai/docs/publishing): Schedule posts, threads, stories, reels and videos, with queues, drafts and approvals.
- [Inbox](https://pozy.ai/docs/inbox): Read and answer DMs, comments, reviews and mentions from one place.
- [Automations](https://pozy.ai/docs/automations): Comment-to-DM, workflows, sequences and broadcasts.
- [Analytics](https://pozy.ai/docs/analytics): Reach, engagement, followers, best time to post and content decay.
- [Ads](https://pozy.ai/docs/ads): Create, boost and measure campaigns on nine ad networks.
- [WhatsApp](https://pozy.ai/docs/whatsapp): Templates, flows, broadcasts, calling and a business agent.
- [Phone, SMS & voice](https://pozy.ai/docs/telephony): Buy numbers, send texts, place calls and run AI voice agents.
- [Build a platform](https://pozy.ai/docs/build): Give every one of your customers their own profile, keys and webhooks.

## Ways to use Pozy

| Surface | Best for | Start |
| --- | --- | --- |
| REST API | Your own product, backend jobs, anything custom | [Quickstart](https://pozy.ai/docs/getting-started/quickstart) |
| Node.js | TypeScript and JavaScript apps, with the built-in `fetch` | [Node.js](https://pozy.ai/docs/sdks/node) |
| curl | Scripts, CI and quick checks from a terminal | [From the terminal](https://pozy.ai/docs/cli) |
| MCP server | Claude, ChatGPT, Cursor and other AI assistants | [MCP server](https://pozy.ai/docs/mcp) |
| No-code tools | n8n, Make and Zapier | [Integrations](https://pozy.ai/docs/integrations) |

## Base URL

All requests go to `https://api.pozy.ai/v1` and authenticate with a bearer key:

```bash cURL
curl https://api.pozy.ai/v1/accounts \
  -H "Authorization: Bearer pz_live_..."
```
```ts Node
const res = await fetch("https://api.pozy.ai/v1/accounts", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(data.accounts);
```
```python Python
import os, requests

resp = requests.get(
    "https://api.pozy.ai/v1/accounts",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
)
print(resp.json()["accounts"])
```

> **Using an AI assistant?:**
> 
> Every page has a **Copy page** button that copies it as Markdown. The whole site is also available as plain text at [/llms.txt](https://pozy.ai/llms.txt) and [/llms-full.txt](https://pozy.ai/llms-full.txt).

## Supported platforms

| Platform | Publish | Analytics | DMs | Comments | Reviews | Connect |
| --- | --- | --- | --- | --- | --- | --- |
| Instagram | Yes | Yes | Yes | Yes | – | OAuth |
| TikTok | Yes | Yes | Yes | Yes | – | OAuth |
| YouTube | Yes | Yes | – | Yes | – | OAuth |
| Facebook | Yes | Yes | Yes | Yes | Yes | OAuth |
| LinkedIn | Yes | Yes | – | Yes | – | OAuth |
| X | Yes | Yes | Yes | Yes | – | OAuth |
| Threads | Yes | Yes | – | Yes | – | OAuth |
| Pinterest | Yes | Yes | – | – | – | OAuth |
| Bluesky | Yes | Yes | Yes | Yes | – | Credentials |
| Google Business Profile | Yes | Yes | – | – | Yes | OAuth |
| Snapchat (beta) | Yes | Yes | – | – | – | OAuth |
| Reddit (paused) | Yes | Yes | Yes | Yes | – | OAuth |
| WhatsApp | Yes | – | Yes | – | – | Credentials |
| Telegram (coming soon) | Yes | – | Yes | – | – | Bot token |
| Discord (coming soon) | Yes | – | – | – | – | Bot token |
| Slack | Yes | – | Yes | – | – | Bot token |
| iMessage | – | – | Yes | – | – | Phone number |
| SMS | – | – | Yes | – | – | Phone number |
| RCS | – | – | Yes | – | – | Phone number |
| Meta Ads | – | – | – | – | – | OAuth |
| Google Ads | – | – | – | – | – | OAuth |
| TikTok Ads | – | – | – | – | – | OAuth |
| LinkedIn Ads | – | – | – | – | – | OAuth |
| Pinterest Ads | – | – | – | – | – | OAuth |
| X Ads | – | – | – | – | – | OAuth |
| ChatGPT Ads | – | – | – | – | – | API token |
| Reddit Ads | – | – | – | – | – | OAuth |
| Whop Ads | – | – | – | – | – | API token |
| Shopify | – | – | – | – | – | OAuth |
| WooCommerce | – | – | – | – | – | Credentials |
| WordPress | – | – | – | – | – | OAuth |
| Wix | – | – | – | – | – | OAuth |
| Webflow | – | – | – | – | – | API token |
| HubSpot | – | – | – | – | – | OAuth |
| Google Analytics | – | – | – | – | – | OAuth |
| Google Workspace | – | – | – | – | – | OAuth |
| Microsoft 365 | – | – | – | – | – | OAuth |

See [Platforms](https://pozy.ai/docs/platforms) for what each one supports, its media limits and how to connect it.