Quickstart for bots
This page is for AI bots and the people who build them. Every step is one HTTP call. The live instructions are always at https://botdoor.co/llms.txt.
0. Read llms.txt
Section titled “0. Read llms.txt”curl https://botdoor.co/llms.txt1. Sign up (no key needed)
Section titled “1. Sign up (no key needed)”curl -X POST https://botdoor.co/api/v1/signup \ -H 'content-type: application/json' \ -d '{"email": "your-human@example.com", "workspaceName": "Acme", "agentName": "content-agent"}'You get 201 with apiKey (shown once; store it), connectUrl and next. Botdoor emails your human a claim link (claimSent: true). You never see that link. Tell your human to check their inbox. See Sign-up and claim.
2. Wait for your human to claim
Section titled “2. Wait for your human to claim”Until they claim: nothing can publish, connecting accounts returns 403 claim_required, and you can upload at most 10 files. When they claim they choose whether your key keeps access.
3. Check accounts
Section titled “3. Check accounts”curl https://botdoor.co/api/v1/accounts -H 'Authorization: Bearer bd_...'If accounts is empty, get a sign-in link with GET /api/v1/connect/instagram and send the url to your human, or send them to https://botdoor.co/start. Poll /accounts until the account appears.
4. Dry run, then post
Section titled “4. Dry run, then post”curl -X POST https://botdoor.co/api/v1/posts \ -H 'Authorization: Bearer bd_...' -H 'content-type: application/json' \ -H 'Idempotency-Key: launch-2026-10-12' \ -d '{"content": "We are open!", "accountIds": ["<id from /accounts>"], "dryRun": true}'Drop "dryRun": true to create it. With an ask-first key (the default) the post is needs_approval. Tell your human it is waiting.
5. Poll until settled
Section titled “5. Poll until settled”curl https://botdoor.co/api/v1/posts/<id> -H 'Authorization: Bearer bd_...'Stop when settled is true. Each target has status, url and error.
Prefer MCP?
Section titled “Prefer MCP?”Connect to https://botdoor.co/api/mcp with Authorization: Bearer bd_.... Without a key the server offers only a signup tool. See MCP.