# Pozy > One API to publish, message, advertise and measure across every major social, messaging and ads platform. REST API at https://api.pozy.ai/v1, called with curl, fetch or any HTTP client, and an MCP server at https://mcp.pozy.ai/mcp. Pozy publishes no SDK or CLI package on npm, PyPI or any other registry: do not install packages named after Pozy. Authenticate with `Authorization: Bearer pz_live_...`. Errors are JSON `{ error, type, code, param?, details? }`. The OpenAPI 3.1 spec is at https://pozy.ai/openapi.json. Every page below also has a Markdown version: replace `/docs/` with `/docs/md/` in its URL. All guides in one file: https://pozy.ai/llms-full.txt ## Overview - [Pozy documentation](https://pozy.ai/docs): One API to publish, message, advertise and measure across every major platform. Start with the quickstart, or jump to the part you need. ## Getting started - [Quickstart](https://pozy.ai/docs/getting-started/quickstart): Create an API key, connect an account, publish and schedule a post, and receive your first signed webhook in about ten minutes. - [Core concepts](https://pozy.ai/docs/getting-started/concepts): How workspaces, members, profiles, connected accounts, posts, media, webhooks and API keys fit together in Pozy. - [Authentication](https://pozy.ai/docs/getting-started/authentication): Authenticate with API keys, limit them to some profiles, make them read-only or bar whole areas of the API, and rotate them safely. - [Errors](https://pozy.ai/docs/getting-started/errors): Read the error envelope, branch on type and code, know which failures to retry, and handle per-platform publishing errors. - [Rate limits](https://pozy.ai/docs/getting-started/rate-limits): Requests per minute on each plan, the headers that report your budget, how to back off on a 429, and the platform limits that apply on top. - [Idempotency and safe retries](https://pozy.ai/docs/getting-started/idempotency): Send an Idempotency-Key so a retried create returns the original result instead of a second post, message, call or ad. - [Pagination](https://pozy.ai/docs/getting-started/pagination): Page through list endpoints with page and limit, skip, or cursors, and keep a local copy in sync with updatedSince. - [Versioning and changes](https://pozy.ai/docs/getting-started/versioning): How the Pozy API changes over time, how deprecations are flagged, and how to follow changes with the changelog endpoint. ## Build a platform - [Build a platform](https://pozy.ai/docs/build): Give each of your customers their own profile, connect their accounts, act on their behalf and route every webhook back to the right customer. - [Profiles](https://pozy.ai/docs/build/profiles): Create, find, update and delete profiles, use externalId for your own ids, set a default profile and timezone, and move accounts between profiles. - [Per-customer API keys](https://pozy.ai/docs/build/tenant-keys): Issue an API key per customer that only reaches their profile, make it read-only or bar whole areas of the API, and rotate it without downtime. - [Route webhooks to tenants](https://pozy.ai/docs/build/route-webhooks): Use the profiles array on every event to send each webhook to the right customer, filter endpoints by profile or account, and fan out safely. ## Connecting accounts - [Connecting accounts](https://pozy.ai/docs/connect): How social, messaging, ads, store and workspace accounts get into Pozy, and how to keep them connected. - [Hosted connect pages](https://pozy.ai/docs/connect/hosted-connect): Start an OAuth connect with one API call, send the user through Pozy's hosted pages and read the result on your redirect URL. - [Headless selection](https://pozy.ai/docs/connect/headless): Build your own picker for Facebook Pages, Instagram accounts, LinkedIn pages, Pinterest boards, business locations and more, after the user approves on the platform. - [Credentials and bots](https://pozy.ai/docs/connect/credentials): Connect Bluesky, self-hosted WordPress and WooCommerce, Webflow, Shopify custom apps, WhatsApp, ChatGPT Ads and Slack without the standard OAuth redirect. Telegram and Discord are coming soon. - [Welcome screen](https://pozy.ai/docs/connect/welcome-screen): Show your name, logo and colours before the platform's consent screen, per link or for every connect in the workspace. - [Phone handoff](https://pozy.ai/docs/connect/phone-handoff): Let users on a computer finish connecting on their phone by scanning a QR code, where the platform's app already has them signed in. - [Scopes and permissions](https://pozy.ai/docs/connect/scopes): Ask only for the permission areas your product uses, see what each account was actually granted, and handle missing permissions. - [Use your own platform apps](https://pozy.ai/docs/connect/own-apps): Coming soon. Connect your customers through your own app on each platform, so the consent screen shows your name and the platform's quotas are yours. - [Account health](https://pozy.ai/docs/connect/account-health): Check token status, granted permissions and sync status for every connected account, and catch disconnects before your users do. - [Account groups](https://pozy.ai/docs/connect/account-groups): Save named sets of accounts, such as all of a brand's channels, and reuse them when you post or report. ## Publishing - [Create a post](https://pozy.ai/docs/publishing): Publish, schedule, queue or save a post to one or many connected accounts with a single POST /v1/posts request. - [Post lifecycle](https://pozy.ai/docs/publishing/lifecycle): Every post status and per-platform status, how a post moves between them, what you can do in each, and which webhook fires on each change. - [Scheduling and timezones](https://pozy.ai/docs/publishing/scheduling): Schedule posts at a local wall-clock time with scheduledFor and an IANA timezone, give each platform its own time, and reschedule safely. - [Queues and recycling](https://pozy.ai/docs/publishing/queues): Give a profile recurring weekly posting slots, add posts to the next free slot with queuedFromProfile, and republish evergreen posts on a schedule. - [Drafts and approvals](https://pozy.ai/docs/publishing/drafts-approvals): Save posts as drafts, hold them for review with requiresApproval, and approve or reject them with one call before anything goes live. - [Media uploads](https://pozy.ai/docs/publishing/media): Upload images, videos and documents with a presigned URL, attach them to posts with mediaItems, and add alt text, thumbnails and captions. - [Platform settings](https://pozy.ai/docs/publishing/platform-settings): Set per-platform options with platformSpecificData, apply TikTok and Facebook settings to every entry at once, and know which value wins. - [Threads](https://pozy.ai/docs/publishing/threads): Publish a chain of connected posts on X, Threads and Bluesky with threadItems, each with its own text and media. - [First comments](https://pozy.ai/docs/publishing/first-comments): Post a first comment automatically right after a post goes live on Instagram, Facebook, LinkedIn, YouTube and Threads. - [CSV import](https://pozy.ai/docs/publishing/csv-import): Create many posts at once from a CSV file with POST /v1/posts/bulk-upload, check the file with a dry run first, or script the import yourself with idempotency keys. - [Edit, unpublish and delete](https://pozy.ai/docs/publishing/editing): Change a post before it publishes, edit published text where the platform allows it, update YouTube video details, take posts down and pin Facebook posts. - [Validation and dry runs](https://pozy.ai/docs/publishing/validation): Check text length, media and a full post against every platform's rules before you create it, and ask whether a TikTok account can publish right now. - [External posts](https://pozy.ai/docs/publishing/external-posts): See posts your users published directly on a platform, outside Pozy, get webhooks when they appear, change or disappear, and import one on demand. ## Platforms - [Platforms](https://pozy.ai/docs/platforms): Every platform Pozy connects to, what each one supports, its API id, and how one post request reaches all of them. - [Instagram](https://pozy.ai/docs/platforms/instagram): Publish feed posts, carousels, Stories and Reels to Instagram, read account and post insights, and answer DMs and comments. - [TikTok](https://pozy.ai/docs/platforms/tiktok): Publish TikTok videos and photo carousels with the right privacy and disclosure settings, send drafts to the Creator Inbox, and read post and account insights. - [YouTube](https://pozy.ai/docs/platforms/youtube): Upload videos and Shorts to a YouTube channel with titles, thumbnails, playlists and visibility, edit them after publishing, and read channel analytics and transcripts. - [Facebook](https://pozy.ai/docs/platforms/facebook): Publish feed posts, multi-image posts, link carousels, Stories and Reels to Facebook Pages, and run Messenger DMs, comments and Page reviews. - [LinkedIn](https://pozy.ai/docs/platforms/linkedin): Publish text, images, video, documents, polls and reposts to LinkedIn profiles and company pages, target page audiences, edit posts and read analytics. - [X](https://pozy.ai/docs/platforms/x): Post to X with threads, replies, quotes, polls and media, edit recent posts, retweet, bookmark and follow, send DMs and read post analytics. - [Threads](https://pozy.ai/docs/platforms/threads): Publish text, image, video and carousel posts and multi-post threads to Threads, set topic tags, manage replies and read post metrics. - [Pinterest](https://pozy.ai/docs/platforms/pinterest): Publish image and video pins to Pinterest boards, create boards, edit pin descriptions and read impressions, saves and clicks. - [Bluesky](https://pozy.ai/docs/platforms/bluesky): Connect Bluesky with an app password, publish text, image, video and thread posts, tag the post language, and answer DMs and comments. - [Google Business Profile](https://pozy.ai/docs/platforms/google-business-profile): Publish updates, events and offers to a Google Business Profile location, reply to reviews and read location performance and search keywords. - [Snapchat](https://pozy.ai/docs/platforms/snapchat): Publish Stories, Saved Stories and Spotlight videos to a Snapchat Public Profile and read views, reach and shares. In beta. - [Reddit](https://pozy.ai/docs/platforms/reddit): Reddit publishing, DMs and comments are paused while Reddit blocks third-party API access. What still works, what to expect, and the reference for when it returns. - [WhatsApp](https://pozy.ai/docs/platforms/whatsapp): Connect a WhatsApp Business number, send templates and replies, run broadcasts, flows, groups and calls, and know the 24-hour window and tier rules. - [Telegram](https://pozy.ai/docs/platforms/telegram): Coming soon. Connect a Telegram channel or group with an access code, publish text, photos, videos, documents and albums, edit messages, and run bot DMs and commands. - [Discord](https://pozy.ai/docs/platforms/discord): Coming soon. Install the bot in a Discord server, publish messages, embeds, polls, forum posts and threads, send DMs, and manage roles, pins and scheduled events. - [Slack](https://pozy.ai/docs/platforms/slack): Install the app in a Slack workspace, publish channel messages and thread replies with files, set the message identity, and handle DMs and mentions in the inbox. - [iMessage](https://pozy.ai/docs/platforms/imessage): Try iMessage on the sandbox line today. Ordering a dedicated sender is not available yet; this page also covers opt-in links, pacing rules for new contacts and rich iMessages. - [SMS](https://pozy.ai/docs/platforms/sms): Send and receive SMS and MMS from your Pozy numbers, register US numbers with carriers, send from a brand name abroad, and handle opt-outs and delivery webhooks. - [RCS](https://pozy.ai/docs/platforms/rcs): Register a verified RCS agent, send rich cards, carousels and buttons to Android and iPhone, fall back to SMS, and receive replies and receipts in the inbox. - [Shopify](https://pozy.ai/docs/platforms/shopify): Connect a Shopify store to manage its catalog, read its orders, publish blog articles and install ad pixels on the storefront. - [WordPress](https://pozy.ai/docs/platforms/wordpress): Connect a WordPress.com or self-hosted WordPress site to publish and schedule articles, run its WooCommerce store and install ad pixels. - [Wix](https://pozy.ai/docs/platforms/wix): Connect a Wix site through Wix's app installer to publish, schedule and edit its blog posts and to add ad pixels without touching the site's code. - [Webflow](https://pozy.ai/docs/platforms/webflow): Connect a Webflow site to publish and edit items in its CMS blog collections and to add ad pixels to the site's custom code. - [HubSpot](https://pozy.ai/docs/platforms/hubspot): Connect a HubSpot portal so inbox contacts become HubSpot contacts, messages land on their timelines and closed-won deals reach your ad platforms. - [Google Analytics](https://pozy.ai/docs/platforms/google-analytics): Connect a GA4 property and run reports, realtime reports and dimension lookups against it with your Pozy API key. - [Google Workspace](https://pozy.ai/docs/platforms/google): Connect a Google account to read and send Gmail, manage Google Calendar events, work with Drive files and sync Google Contacts. - [Microsoft 365](https://pozy.ai/docs/platforms/microsoft): Connect a Microsoft 365 or Outlook.com account to use Outlook mail, Outlook Calendar with Teams meetings, OneDrive files and Outlook contacts. ## Analytics - [Analytics](https://pozy.ai/docs/analytics): Read reach, engagement, followers and inbox activity for every connected account, and keep your own copy fresh with a cursor feed and a webhook. - [Post analytics](https://pozy.ai/docs/analytics/post-analytics): List every post with its metrics, sort and filter by engagement, look up one post across platforms, and chart day-by-day performance. - [Platform insights](https://pozy.ai/docs/analytics/platform-insights): Which metrics each platform returns for posts, and the account-level endpoints for Instagram, Facebook, YouTube, LinkedIn, TikTok and Google Business Profile. - [Best time to post](https://pozy.ai/docs/analytics/best-time): Find the hours of the week when your own posts get the most engagement, and how often to post on each platform, from your publishing history. - [Content decay](https://pozy.ai/docs/analytics/content-decay): See how quickly your posts collect their engagement after publishing, per platform, and use it to time reposts, boosts and reporting. - [Tracking and authenticity](https://pozy.ai/docs/analytics/tracking): Watch a post's numbers for a set number of days, read every verified sample, and score whether its views look organic. - [Inbox analytics](https://pozy.ai/docs/analytics/inbox-analytics): Measure DM volume, time to first response, busiest hours, message sources and the accounts that get the most conversations. ## Inbox - [Inbox](https://pozy.ai/docs/inbox): One inbox for DMs, comments, reviews and mentions across every connected account, fed by webhooks and answered through the API. - [Messages](https://pozy.ai/docs/inbox/messages): List conversations, read their messages, reply with text, media, buttons and quick replies, start new DMs, and hand a thread to another app. - [Comments](https://pozy.ai/docs/inbox/comments): Read comments on your posts across platforms, reply, like, hide, pin and moderate them, and send a private DM to a commenter. - [Reviews](https://pozy.ai/docs/inbox/reviews): List Google Business Profile and Facebook reviews in one feed, filter by rating, reply, and react to new, edited and removed reviews by webhook. - [Mentions](https://pozy.ai/docs/inbox/mentions): See where other people tag your accounts on Instagram, Facebook and LinkedIn, reply to Instagram mentions, and search and engage on X. - [Contacts](https://pozy.ai/docs/inbox/contacts): Keep one record per person across your messaging channels, with tags, notes and subscription state, and use it to target broadcasts and sequences. - [Custom fields](https://pozy.ai/docs/inbox/custom-fields): Define typed fields on contacts, such as plan, city or renewal date, set them from your app or a workflow, and use them in segments and messages. ## Automations - [Automations](https://pozy.ai/docs/automations): Answer comments with DMs, run conversation workflows, send drip sequences and broadcasts, and set up the prompts people see when they open a chat. - [Comment to DM](https://pozy.ai/docs/automations/comment-to-dm): Send a DM, a public reply or both when someone comments a keyword, replies to a story or mentions you, with follower rules, link tracking and repeat limits. - [Workflows](https://pozy.ai/docs/automations/workflows): Build conversation flows that run on one messaging account when a trigger fires: send messages, wait for answers, branch, call your backend and hand off to a person. - [Workflow nodes](https://pozy.ai/docs/automations/workflow-nodes): Every workflow node type, its config fields, its outputs and the platforms it runs on, from send_message and conditions to webhooks, AI and calls. - [Sequences](https://pozy.ai/docs/automations/sequences): Send a series of timed messages to contacts who opted in, with automatic exits when they reply or unsubscribe, on WhatsApp, Instagram, Facebook and more. - [Broadcasts](https://pozy.ai/docs/automations/broadcasts): Send one message to many contacts at once, now or at a scheduled time, with per-recipient variables, segments and delivery tracking. - [Conversation starters](https://pozy.ai/docs/automations/conversation-starters): Set the greeting, Get Started button, ice breakers and persistent menu people see when they open a chat with your Facebook Page or Instagram account, plus the WhatsApp equivalent. ## Ads - [Ads](https://pozy.ai/docs/ads): Create, boost and measure campaigns on nine ad networks with one set of endpoints, from Meta and Google to LinkedIn, TikTok, ChatGPT and Whop. - [Meta Ads](https://pozy.ai/docs/ads/meta-ads): Run Facebook and Instagram campaigns from the API, with conversation ads, creative testing, reach and frequency buys, previews and live insights. - [Google Ads](https://pozy.ai/docs/ads/google-ads): Create Search, Display, Performance Max and Demand Gen campaigns, manage keywords and assets, apply recommendations and query GAQL from the API. - [TikTok Ads](https://pozy.ai/docs/ads/tiktok-ads): Boost TikTok videos as Spark Ads, create video campaigns with pixel conversions, manage ad comments and run live TikTok reports. - [LinkedIn Ads](https://pozy.ai/docs/ads/linkedin-ads): Create and boost LinkedIn campaigns with B2B targeting, every creative format, matched audiences, bid and delivery forecasts and the public ad library. - [Pinterest Ads](https://pozy.ai/docs/ads/pinterest-ads): Run Promoted Pins on a pinterestads account, from a new Pin or one you already published, with targeting, customer lists, the Pinterest tag and conversions. - [X Ads](https://pozy.ai/docs/ads/x-ads): Run promoted posts on X from an xads connection, with website cards, Tailored Audiences, bid control and the X Pixel. - [Reddit Ads](https://pozy.ai/docs/ads/reddit-ads): Run image, video, carousel and text ads on Reddit, promote existing posts, target subreddits and keywords, and send conversions to a Reddit pixel. - [ChatGPT Ads](https://pozy.ai/docs/ads/chatgpt-ads): Run chat card campaigns in ChatGPT from an openaiads connection, connected with an Ads Manager API key, and measure them with the pixel and server-side conversions. - [Boost posts](https://pozy.ai/docs/ads/boost-posts): Turn a published Facebook, Instagram, TikTok, LinkedIn, Pinterest, X or Reddit post into an ad that keeps its likes and comments. - [Targeting](https://pozy.ai/docs/ads/targeting): Target ads by location, age, interests, keywords, job titles or subreddits, look up each network's ids with one search endpoint and estimate reach first. - [Audiences](https://pozy.ai/docs/ads/audiences): Build customer lists, lookalikes, website, engagement and company audiences on each ad network, upload hashed members and target them. - [Conversions API](https://pozy.ai/docs/ads/conversions): Send purchases, leads and offline conversions from your server to Meta, Google, LinkedIn, TikTok, Pinterest, Reddit and ChatGPT with one event shape. - [Pixels and tracking tags](https://pozy.ai/docs/ads/pixels): Create, install and verify each ad network's pixel or site tag through one API, and set the click-URL parameters (UTMs) that ads carry to your site. - [Automated ad rules](https://pozy.ai/docs/ads/rules): Pause, reactivate or rebudget campaigns, ad sets and ads on a schedule when their metrics cross a threshold, or get a webhook when they do. - [Lead forms](https://pozy.ai/docs/ads/lead-forms): Collect leads inside Meta and LinkedIn ads with native forms, receive them by webhook or by polling, and route them into your CRM. - [Product catalogs and catalog ads](https://pozy.ai/docs/ads/catalogs): Build and fill a Meta product catalog, group products into sets, and run catalog ads that show each person the products they are most likely to buy. - [Ads reporting](https://pozy.ai/docs/ads/reporting): Read spend, delivery and conversion metrics across every ad network, from rolled-up dashboards to breakdowns, live network queries and sync health events. ## WhatsApp - [Connect WhatsApp](https://pozy.ai/docs/whatsapp): Connect a WhatsApp Business number to a profile with Embedded Signup or a Meta token, set its business profile and watch its quality and limits. - [Message templates](https://pozy.ai/docs/whatsapp/templates): Create WhatsApp templates, follow Meta's review, fill variables, media headers and buttons, and send a template to start a conversation. - [WhatsApp Flows](https://pozy.ai/docs/whatsapp/flows): Build native forms, surveys and booking screens inside WhatsApp, publish them, send them and read what customers submit. - [Group chats](https://pozy.ai/docs/whatsapp/groups): Create WhatsApp groups owned by your business number, manage participants, invite links and join requests, and message the group from the inbox. - [WhatsApp calling](https://pozy.ai/docs/whatsapp/calling): Turn on WhatsApp voice calls for a number, route them to a phone, SIP endpoint or AI agent, ask customers for permission and place outbound calls. - [WhatsApp broadcasts](https://pozy.ai/docs/whatsapp/broadcasts): Send an approved template to a list of contacts with per-person variables, now or later, and track who received and read it. - [Business AI agent](https://pozy.ai/docs/whatsapp/business-agent): Set up Meta's AI agent on a WhatsApp number through the API, teach it about the business, test it, roll it out and hand chats back to people. - [WhatsApp sandbox](https://pozy.ai/docs/whatsapp/sandbox): Test WhatsApp sends, replies and webhooks from a shared Pozy number before you buy or connect a number of your own. Free. - [WhatsApp pricing](https://pozy.ai/docs/whatsapp/pricing): Which WhatsApp costs Pozy bills, which ones Meta bills to your WhatsApp Business Account, and how to read Meta's numbers through the API. - [Phone numbers for WhatsApp](https://pozy.ai/docs/whatsapp/phone-numbers): Buy a WhatsApp-ready number, bring your own, verify and register it with Meta, check that it is alive and follow its lifecycle events. ## Phone, SMS & voice - [Phone numbers](https://pozy.ai/docs/telephony): Buy or port real phone numbers, then turn on calls, SMS and WhatsApp on the same number with one API. - [Buy a number](https://pozy.ai/docs/telephony/buy-a-number): Search live inventory, buy a number in one request, watch sold-out countries and release numbers you no longer need. - [Port a number in](https://pozy.ai/docs/telephony/porting): Move a number you already own at another carrier onto Pozy. Check portability, upload the authorization documents, submit and track the order. - [KYC for regulated countries](https://pozy.ai/docs/telephony/kyc): Submit the identity details a regulated country requires, hand the form to your customer with a branded link, and fix a declined number. - [Send SMS](https://pozy.ai/docs/telephony/sms): Send SMS and MMS from your numbers, handle replies and delivery receipts, respect opt-outs, look up line types and send one-time codes. - [US 10DLC registration](https://pozy.ai/docs/telephony/10dlc): Not available yet. Register a US number with the carriers so it can send SMS, as a company, a sole proprietor or a toll-free number, then reuse the approval on more numbers. - [Alphanumeric sender IDs](https://pozy.ai/docs/telephony/sender-ids): Send one-way international SMS from your brand name instead of a phone number, with a daily limit and per-country behaviour. - [Voice calls](https://pozy.ai/docs/telephony/voice-calls): Route inbound calls to a phone, a SIP address or an AI agent, add voicemail, business hours and an IVR menu, and place, transfer and end outbound calls. - [AI voice agents](https://pozy.ai/docs/telephony/ai-voice-agents): Have an AI voice agent answer your number or take outbound calls, either a hosted agent over SIP or your own speech pipeline over a WebSocket. - [SIP trunks](https://pozy.ai/docs/telephony/sip-trunks): Connect your own PBX or voice AI platform to your Pozy numbers over SIP, so it receives inbound calls directly and places outbound calls with your number. - [Browser calling](https://pozy.ai/docs/telephony/browser-calling): Let your users place phone calls from a web page. Mint a short-lived session on your server, register it in the browser, then dial. - [Call history and recordings](https://pozy.ai/docs/telephony/call-recordings): Read every call across your numbers and channels from one feed, open a call with its transcript, and fetch a fresh recording link. - [Branded calling](https://pozy.ai/docs/telephony/branded-calling): Not available yet. Show your business name, logo and reason for calling on the callee's phone when you call from US numbers. Register the business, pass vetting, attach numbers. ## Google Business - [Google Business management](https://pozy.ai/docs/google-business): Run Google Business Profile listings through Pozy, from one location to hundreds: posts, reviews, hours, photos, services, menus and verification. - [Location details](https://pozy.ai/docs/google-business/locations): Read and update a Google Business Profile listing: hours, holiday hours, description, contact details, categories, attributes and action links. - [Google reviews](https://pozy.ai/docs/google-business/reviews): List Google Business Profile reviews, reply and remove replies, read reviews across many locations, and get an event when a review arrives or changes. - [Google Business posts](https://pozy.ai/docs/google-business/posts): Publish updates, events and offers to a Google Business Profile location, add a call-to-action button, post to many locations at once and edit published posts. - [Photos and videos](https://pozy.ai/docs/google-business/media): List, add and remove the photos and videos on a Google Business Profile listing, and choose where each one appears. - [Services and food menus](https://pozy.ai/docs/google-business/services-menus): Keep the services a Google Business Profile location offers, and the menus of a restaurant or cafe, in sync with your own system. - [Verify a location](https://pozy.ai/docs/google-business/verifications): Check whether a Google Business Profile location is verified, see which methods Google offers, start a verification and submit the code. ## Commerce & blogs - [Commerce & blogs](https://pozy.ai/docs/commerce): Connect Shopify, WooCommerce, WordPress, Wix and Webflow to manage catalogs, read orders, publish blog articles and install ad pixels with one API. - [Products and catalog](https://pozy.ai/docs/commerce/products): List, create and edit products, variants, images and stock on Shopify and WooCommerce, organise collections and discounts, and sync a store into a Meta catalog. - [Orders](https://pozy.ai/docs/commerce/orders): Read Shopify and WooCommerce orders in one shape, with line items, tax, refunds and attribution, and keep them in sync with webhooks instead of polling. - [Publish blog articles](https://pozy.ai/docs/commerce/blogs): Create, schedule, update and delete blog articles on Shopify, WordPress, Wix and Webflow with one request shape. - [Site pixels](https://pozy.ai/docs/commerce/site-pixels): Install Meta, TikTok, Google, LinkedIn, Pinterest, X and ChatGPT tags on a connected Shopify, WordPress, Wix or Webflow site with one call, then check and remove them. ## Email, calendar & files - [Email, calendar & files](https://pozy.ai/docs/productivity): Read and send email, manage calendar events and work with files in your users' own Google and Microsoft accounts through one API. - [Email](https://pozy.ai/docs/productivity/email): List, search and read threads, send and reply from a connected Gmail or Outlook mailbox, manage folders and attachments, and stay inside the daily send cap. - [Calendar](https://pozy.ai/docs/productivity/calendar): List calendars and events, create events with Google Meet or Teams links, answer invitations and find free meeting slots across Google and Microsoft mailboxes. - [Files](https://pozy.ai/docs/productivity/files): List, search, upload, download, organise and share files in a user's Google Drive or OneDrive, let users pick Drive files, and use them as post media. ## Creator campaigns - [Creator campaigns](https://pozy.ai/docs/creators): Pay creators for verified views or approved posts. Create a campaign, invite creators, review what they post and pay what they earned. - [Run a campaign](https://pozy.ai/docs/creators/campaigns): Create and activate a creator campaign, invite creators, let them submit through the hosted portal, and approve or reject what they post. - [Pay creators](https://pozy.ai/docs/creators/payouts): Pay what creators earned by card in one charge, from a prepaid balance, or on your own rails, with a 4% fee (minimum $0.50) added on top. ## Webhooks - [Set up webhooks](https://pozy.ai/docs/webhooks): Receive an HTTPS POST from Pozy when a post publishes, a message arrives or an account disconnects. Create an endpoint, verify it, and handle your first event. - [Verify signatures](https://pozy.ai/docs/webhooks/signatures): Check X-Pozy-Signature, a hex HMAC-SHA256 of the raw request body keyed with your endpoint secret, so you only act on requests that came from Pozy. - [Retries and delivery logs](https://pozy.ai/docs/webhooks/retries): How Pozy retries failed webhook deliveries (7 attempts over about 33 hours), when an endpoint is switched off, and how to read logs and redeliver events. - [Idempotency and ordering](https://pozy.ai/docs/webhooks/idempotency): Handle duplicate and out-of-order webhook deliveries safely by deduplicating on X-Pozy-Event-Id and reading state rather than trusting arrival order. - [Test webhooks](https://pozy.ai/docs/webhooks/testing): Send test events to an endpoint, receive webhooks on your laptop through a tunnel, replay real deliveries and write signed fixtures for your test suite. - [Webhook events reference](https://pozy.ai/docs/webhooks/events): Every event Pozy can send to your endpoint, grouped by area, with when it fires and an example payload. ## SDKs - [SDKs](https://pozy.ai/docs/sdks): Pozy has no published client libraries yet. Call the REST API with curl, fetch or any HTTP client, generate a client from the OpenAPI spec, or connect an assistant to the MCP server. - [Node.js](https://pozy.ai/docs/sdks/node): Call the Pozy API from Node.js and TypeScript with the built-in fetch, including a small copyable wrapper for errors, idempotency, retries, uploads and pagination. - [OpenAPI spec](https://pozy.ai/docs/sdks/openapi): Download the Pozy OpenAPI 3.1 spec, generate a client in any language, and import the API into Postman, Insomnia or Bruno. ## CLI - [Pozy CLI](https://pozy.ai/docs/cli): The Pozy command line tool is not published yet. From a terminal, a script or CI, use curl against the REST API, or connect your assistant to the MCP server. ## MCP server - [MCP server](https://pozy.ai/docs/mcp): Connect Claude, ChatGPT, Cursor, Codex, VS Code or any MCP client to Pozy so your assistant can post, reply, report and run ads on your connected accounts. - [Connect a client](https://pozy.ai/docs/mcp/connect): Step-by-step setup of the Pozy MCP server in Claude, Claude Code, ChatGPT, Cursor, Codex, VS Code and any other MCP client, with OAuth or an API key. - [MCP tools](https://pozy.ai/docs/mcp/tools): Every tool the Pozy MCP server offers, with its arguments, plus how search_tools and call_tool reach the rest of the API. - [OAuth for MCP clients](https://pozy.ai/docs/mcp/oauth): How MCP clients sign in to Pozy with OAuth 2.1: discovery, client registration, PKCE, scopes, workspace choice, read-only access, token lifetimes and revoking access. - [Things to ask](https://pozy.ai/docs/mcp/prompts): Requests that work well once Pozy is connected to your AI assistant, for posting, scheduling, the inbox, analytics, ads and account housekeeping. - [Troubleshooting the MCP server](https://pozy.ai/docs/mcp/troubleshooting): Fixes for common problems with the Pozy MCP server, from sign-in loops and the wrong workspace to expired tokens, accounts that need reconnecting and tool limits. ## Integrations - [Integrations](https://pozy.ai/docs/integrations): Use Pozy from n8n, Make, Zapier or any automation tool through plain HTTP requests and webhooks, with the settings, safety habits and recipes that carry over. - [n8n](https://pozy.ai/docs/integrations/n8n): Create and schedule posts from n8n with the HTTP Request node, and start workflows from Pozy webhooks with a verified signature. - [Make](https://pozy.ai/docs/integrations/make): Create and schedule posts from a Make scenario with the HTTP module, and trigger scenarios from Pozy webhooks. - [Zapier](https://pozy.ai/docs/integrations/zapier): Create and schedule posts from a Zap with Webhooks by Zapier, and start Zaps from Pozy events with a signature check in Code by Zapier. ## Pricing & billing - [Pricing](https://pozy.ai/docs/billing): Pozy charges per connected account per month on a graduated ladder, with the first two free, plus usage-based items such as messages, ads, X calls, numbers and calls. - [Billing and payments](https://pozy.ai/docs/billing/billing): When Pozy charges your card, how early charges work, what a 402 payment_required means, X spend caps, failed payments and who can manage billing. - [Usage and spend](https://pozy.ai/docs/billing/usage): Read what your workspace has used and spent this period, break it down by day, product, profile or account, and track calls and SMS volumes. ## Security - [Security](https://pozy.ai/docs/security): How Pozy protects sign-in, API keys, webhooks and team access, and the logs you can use to see who did what. - [Single sign-on](https://pozy.ai/docs/security/sso): Connect a SAML 2.0 or OIDC identity provider to your workspace, verify your email domain over DNS and let your team sign in through it. - [SCIM provisioning](https://pozy.ai/docs/security/scim): Pozy does not support SCIM directory provisioning yet. How to manage joiners and leavers today with SSO, invites and roles. - [Two-step verification](https://pozy.ai/docs/security/two-factor): Protect password sign-in with a code from an authenticator app, and keep backup codes for when you lose your phone. - [Roles and permissions](https://pozy.ai/docs/security/roles): What owners, admins, members, viewers and billing users can do in a workspace, and how API keys and OAuth tokens are limited. - [Data residency](https://pozy.ai/docs/security/data-residency): Where Pozy stores customer data, which subprocessors handle it, how long it is kept and how to ask for deletion. ## Resources - [API reference](https://pozy.ai/docs/api) - [Glossary](https://pozy.ai/docs/resources/glossary): Every Pozy term in a sentence or two, with the field or endpoint where you will meet it. - [Changelog](https://pozy.ai/docs/changelog) - [Support and feedback](https://pozy.ai/docs/resources/support): How to get help with Pozy, what to include so we can answer fast, how to look up a failed request yourself, and how to report bugs and missing features from code. - [OpenAPI spec](https://pozy.ai/openapi.json) - [llms.txt](https://pozy.ai/llms.txt) ## API reference - [API reference index](https://pozy.ai/docs/md/api): every endpoint with method, path and summary, grouped by area and tag. - Accounts & connections: Account Groups, Account Settings, Accounts, Connect, Profiles (124 endpoints, https://pozy.ai/docs/api#area-accounts) - Publishing: Blogs, Media, Posts, Queue, Tools, Validate (36 endpoints, https://pozy.ai/docs/api#area-publishing) - Analytics: Analytics, Inbox Analytics (48 endpoints, https://pozy.ai/docs/api#area-analytics) - Inbox: Comments, Instagram, LinkedIn Mentions, Mentions, Messages, Reddit Search, Reviews, X Engagement (67 endpoints, https://pozy.ai/docs/api#area-inbox) - Automations: Broadcasts, Comment Automations, Contacts, Custom Fields, Sequences, Workflows (54 endpoints, https://pozy.ai/docs/api#area-automations) - Ads: Ad Accounts, Ad Audiences, Ad Campaigns, Ad Creatives, Ad Insights, Ad Library, Ad Rules, Ad Targeting, Conversions, Lead Gen, Messaging Ads, Product Catalogs, Reach and Frequency, Tracking Tags (277 endpoints, https://pozy.ai/docs/api#area-ads) - Commerce: Commerce, Products (79 endpoints, https://pozy.ai/docs/api#area-commerce) - Google Business: Google Business Attributes, Google Business Food Menus, Google Business Location Details, Google Business Media, Google Business Place Actions, Google Business Reviews, Google Business Services, Google Business Verifications (25 endpoints, https://pozy.ai/docs/api#area-google-business) - WhatsApp: Business Agent, WhatsApp, WhatsApp Calling, WhatsApp Flows, WhatsApp Phone Numbers, WhatsApp Sandbox, WhatsApp Templates (156 endpoints, https://pozy.ai/docs/api#area-whatsapp) - Messaging: Discord, iMessage, RCS, Slack, SMS, Verify (83 endpoints, https://pozy.ai/docs/api#area-messaging) - Phone & voice: Branded Calling, Calls, Phone Numbers, Voice (69 endpoints, https://pozy.ai/docs/api#area-telephony) - Creators: Creator Campaigns, Creator Portal, Ledger, Treasury (53 endpoints, https://pozy.ai/docs/api#area-creators) - Email, calendar & files: Calendar, Email, Files (29 endpoints, https://pozy.ai/docs/api#area-productivity) - Workspace: API Keys, Changelog, Connected Apps, Feedback, Invites, Logs, Support Assistant, Usage, Users, Webhooks (28 endpoints, https://pozy.ai/docs/api#area-workspace) ## Optional - [OpenAPI spec](https://pozy.ai/openapi.json): the full machine-readable API description. - [Changelog](https://pozy.ai/docs/changelog): what changed, newest first. JSON at https://api.pozy.ai/v1/changelog.