Skip to main content

Create your first bot

Bots are created via POST /api/bots. On creation, MimicBot seeds a default source (your website), enables the always-on capabilities, and kicks off your first crawl automatically.

Before you start​

  • An agency API token. Generate one in the MimicBot dashboard under Settings → API tokens.
  • The URL of the site you want the bot to learn from.

Steps​

  1. Create the bot with a minimal request:

    curl -X POST https://api.mimicbot.app/api/bots \
      -H "Authorization: Bearer $MIMICBOT_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "name": "Acme Support Bot",
        "clientUrl": "https://acme.example"
      }'

  2. Read the 201 response — it contains the full bot record:

    {
      "bot": {
        "id": "...",
        "publicId": "bot_a1b2c3d4e5",
        "name": "Acme Support Bot",
        "clientUrl": "https://acme.example",
        "status": "draft",
        "widgetConfig": { "assistantName": "Assistant", "primaryColor": "#2563EB" },
        "crawlConfig": { "schedule": "manual", "maxPages": 500, "respectRobotsTxt": true },
        "createdAt": "..."
      }
    }

  3. Copy the publicId. You'll need it for the widget install in Install the widget.

  4. Note the status: "draft" — it flips to indexing during the first crawl and then to ready when done. The next page covers this.

What happens on bot creation​

  • A default source of kind website is created pointing at clientUrl.
  • Always-on capabilities (like contact_team) are attached to the bot.
  • A Temporal workflow (botIndexingWorkflow) is enqueued to run the first crawl.

Next​

→ Your first crawl