Use with Agents

You can run Po Once from an AI agent like Claude Code, Cursor, Codex, or Antigravity. Setup takes about five minutes, and you don't need to write any code. If you do write code, there's a short section for you near the end.

Before the setup steps, here's what this actually looks like in practice.

Workflow recipes

The weekly content loop

This is the workflow we built the agent API for. Once a week, ask your agent to pull your analytics, look at what performed, and plan the next week around it. It drafts, you approve, it schedules. The following week, it checks the numbers and tells you what worked.

Try:

"Check my Instagram and TikTok analytics for the last 28 days, then draft and schedule 3 posts for next week based on what performed best."

Repurpose one video everywhere

You made one good video. It deserves more than one platform. Hand it to your agent and let it tune the caption for each network, then schedule everything in one go.

Try:

"Upload launch.mp4, write a caption tuned for each platform, and schedule it for Friday 6pm on Instagram, TikTok, and YouTube."

Listen, then respond

Threads keyword search is quietly one of the most useful things here. Ask your agent to find what people are saying about your topic, then turn that into replies or fresh post ideas. You end up posting into conversations that are already happening.

Try:

"Search Threads for public posts mentioning 'launch tips', summarize the themes, and draft 3 post ideas."

What your agent can do

You don't need special commands. Just say what you want:

Set it up

Before you start

You'll need:

1. A Po Once account
2. An organization inside Po Once
3. At least one connected social account
4. An AI tool that can run commands (Claude Code, Cursor, Codex, Antigravity, OpenClaw, and similar agents all work)

Step 1: Open the AI Agent page

Inside Po Once:

1. Sign in to your account
2. Switch to the correct organization
3. Open the AI Agent page

If you don't see this page, ask your organization owner or admin for access.

Step 2: Create an agent key

On the AI Agent page:

1. Give the key a name you'll recognize later, like CLI, Personal Agent, or Team Assistant
2. Click Create Key

Po Once shows you the key one time only, so keep that tab open until the next step is done.

Step 3: Ask your agent to set itself up

This is the part people expect to be hard, and it isn't. Copy the prompt below and paste it into your AI tool. Your agent handles the installation and setup on its own:

Help me set up Po Once so you can manage my social media accounts.

Skill: Stiffjobs/po-once-agent-skill
Install: npx skills add Stiffjobs/po-once-agent-skill

Documentation:
- https://po-once.com/docs/use-with-agents
- https://po-once.com/docs/api

Please:
1. Install the Po Once agent skill and read its instructions
2. Ask me for my Po Once Agent API token when you need it
3. List any required environment variables or configuration
4. Verify the setup by listing my connected social accounts

When your agent asks for the API Token, paste the key from Step 2.

Step 4: Verify and start

Ask your agent to list your connected accounts. If it can see them, you're connected. Go try one of the recipes above.

For developers

One line:

npx skills add Stiffjobs/po-once-agent-skill

Works in Claude Code, Cursor, Codex, Antigravity, OpenClaw, and any other agent that can run shell commands.

• Skill repo: Stiffjobs/po-once-agent-skill
• API reference: /docs/api

The skill is a thin wrapper around the Po Once agent API, authenticated with your API token. If you'd rather call the endpoints directly, everything is documented at /docs/api.

Security

A few habits worth keeping:

• Use a separate key for each AI tool, with a name that tells you which is which
• Revoke keys you no longer use
• Don't share one key across a whole team
• Review AI-drafted content before it goes out
• Treat your API token like a password. Don't paste it into email, chat, or screenshots

Revoke a key right away if:

• you stop using that AI tool
• a teammate leaves your organization
• a device is lost or replaced
• you think the key may have leaked

You can revoke any key at any time from the AI Agent page. Revoking a key doesn't touch your posts or accounts, so when in doubt, revoke and make a new one.

Frequently asked questions

The AI tool says it cannot connect

Check that:

• you copied the full API Token
• there are no extra spaces before or after it
• the key hasn't been revoked

The AI can connect but cannot find anything

Check that:

• you're in the correct organization
• the organization has connected accounts
• the posts or media you're looking for actually exist in Po Once

The AI made a mistake

It happens. Treat your agent like an assistant, not an autopilot.

What works well:

• ask it to draft first
• review before publishing
• give clearer instructions
• keep high-impact actions manual until you trust the workflow

Final tip

The setup gives your agent hands. What makes it useful is you: your brand knowledge, your taste, your final approval. Let the agent handle the busywork, and keep yourself in the loop for anything your audience will actually see.