{"uid":"cap_xFnAex0eSIXf94xR2V4G0","slug":"twitr-sh-x-community-management-api-914c19b9","name":"twitr.sh X Community Management API","description":"Pay-per-call X/Twitter API for AI agents. Read tweets, search, monitor accounts in real time, and post — paid in USDC via x402. No signup, no API keys.","url":"https://twitr.sh/api/tools/x_community?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"name":{"type":"string","description":"create: the community name."},"action":{"enum":["create","join","leave","delete"],"type":"string","description":"Which community action."},"account":{"type":"string","description":"A connected X handle owned by this wallet (no @)."},"description":{"type":"string","description":"create: optional community description."},"community_id":{"type":"string","description":"join|leave|delete: the community ID."},"community_name":{"type":"string","description":"delete: the community name, as confirmation."}}},"responseSchema":{"type":"json","example":{"items":[{"id":"1493446837214187523","joined":true}],"runId":"tw_example","payment":{"amount":"0.012000","currency":"USD","protocol":"x402"},"duration":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VPJ_TxaF19t0inHpqlUIh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Create, join, leave, or delete X/Twitter Communities on behalf of a connected account, paid per-call in USDC via x402.","exampleAgentPrompt":"Create a new X community called 'AI Builders Hub' with the description 'A space for builders working with AI agents' using my account techfounder22.","exampleUseCases":[{"title":"Launch a brand community on X","prompt":"Create a new X community called 'CryptoDevs United' with description 'For developers building on-chain' — use my account cryptolaunch99."},{"title":"Join an existing X community","prompt":"Have my account dailynewsbot join the X community with ID 1893446837214187523."},{"title":"Delete an owned X community","prompt":"Delete the X community with ID 1893446837214187523 — the community name is 'OldTestCommunity' and the account is myhandle_dev."}],"resultDescription":"Returns a JSON object with an items array containing the community ID and joined status, a runId for tracing, a payment object showing the USDC amount charged via x402, and the call duration in milliseconds.","failureModes":["Invalid or unrecognized community_id when joining, leaving, or deleting — returns error indicating community not found","Account handle not connected to or authorized by this wallet — returns authorization error","Missing required fields for the chosen action (e.g. no name on create, no community_id on join) — returns validation error","Attempting to delete a community with mismatched community_name confirmation — returns confirmation mismatch error","Payment failure if USDC balance is insufficient — returns 402 Payment Required","Rate limiting by X's underlying API — returns upstream rate limit error"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to programmatically manage X/Twitter Community membership or creation on behalf of a wallet-authenticated user, with no API key setup required and per-call USDC billing. Prefer this over building a custom X API integration when you need lightweight, pay-as-you-go community lifecycle management (create, join, leave, delete) without maintaining OAuth credentials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:35:51.170Z","isFirstParty":false,"canonicalSlug":"twitr-sh-x-community-management-api-914c19b9"}