How to Build and Publish a Custom Bot on Poe

November 8, 2026

A Poe bot is a saved prompt plus a model plus optional files, wrapped in a shareable link. No code required for the basic version, though Poe’s server bots do accept Python if you want tool calls.

Most people build one, share it to a team chat, and discover half the group can’t get useful output because the prompt only works for the author. This guide is about avoiding that.

How do I create a bot on Poe in under ten minutes?

  1. Open the Poe sidebar and choose Create bot.
  2. Pick the base model. Start with a fast model, not the most expensive one.
  3. Write the prompt. Keep the role in the first line: “You are a contract-clause reviewer for freelance designers.”
  4. Set a conversation opener that shows the expected input shape.
  5. Test with three different prompts before publishing.

The opener does more work than people expect. If it says “Paste the clause and tell me which party it favors”, users do that. If it says “How can I help?”, they ask vague questions and blame the bot.

How should I structure the bot prompt?

Four blocks, in this order:

  • Role — one sentence, specific about the audience
  • Input expectations — what the user will paste, and what to do if it’s missing
  • Output format — headings, table, or bullet list; pick exactly one
  • Refusals — what the bot must not do (give legal advice, invent numbers, answer off-topic questions)

The refusal block is the difference between a bot that stays useful for a year and one that drifts after a model upgrade. Concrete example: “If the clause is missing a governing-law section, say ‘not stated’ rather than guessing the jurisdiction.”

Keep the whole prompt under about 500 words. Beyond that, later instructions get less attention than the opening ones.

Can I upload reference files to a Poe bot?

Yes. Poe supports knowledge base files per bot, typically PDFs and text files, with per-file size limits (around 10 MB) and a limited total count per bot.

What belongs there:

  • Your brand voice guide, if the bot writes anything public
  • A checklist or rubric the bot should apply
  • Product specs or pricing tables it must not hallucinate

What doesn’t:

  • A 300-page manual. The bot will retrieve the wrong page. Split it into topic files or use a search-based bot instead.
  • Confidential documents you can’t verify the bot’s retention policy for. Check that before uploading anything internal.

How do points work when other people use my bot?

When a user chats with your public bot, they spend their own points, not yours. That’s why publishing is cheap.

Creator mechanics:

  • Public bots can be discovered in Poe’s search and recommended feed
  • Poe pays creators in points based on usage of their bots — a modest but real incentive
  • You can also monetize bots directly, charging other users points per message on top of compute cost

Practical view: treat the creator payout as a small bonus, not a business model. The people who make money on Poe write server bots that wrap a real API, not prompt-only bots.

What are the common failure modes?

  • Model upgrade drift. Poe swaps default models periodically. Pin the model in bot settings or your carefully tuned prompt starts behaving differently overnight.
  • Over-long chats. Bots lose the format rule after 20 messages. Add a reminder in the opener: “Repeat the table format in every reply.”
  • No fallback. If the user pastes the wrong kind of input, an unguarded bot invents an answer. Add an explicit check-first instruction.

Quick Summary

  • A Poe bot is a model plus a prompt plus optional files; creation takes about ten minutes with no code.
  • Structure prompts as role, input expectations, output format, refusals — under ~500 words.
  • Upload small reference files (up to ~10 MB each); never a whole manual.
  • Other users spend their own points, and creators earn points from bot usage.
  • Pin the model and repeat the output-format rule or the bot drifts within one long conversation.
Tags: