Surgemesh

Add a channel directly (admin key). network "sandbox": a built-in test channel, no credentials, never publishes; it enforces the real limits of the network in simulates (bluesky, facebook or instagram; default bluesky). network "bluesky": credentials {handle, app_password} (identifier is accepted for handle) (an app password, never the account password). network "facebook": {token, page_id}; "instagram": {token, ig_user_id}. Credentials are checked with the network before anything is stored (invalid = 400 credentials_invalid, nothing saved), encrypted at rest, and never returned or echoed. No credentials to hand? Use connect_channel (the owner taps a link) or a sandbox test channel.

Cancel a queued post. Undelivered deliveries are refunded to credit.

Check whether the TXT record is visible; verifies the account when it is.

Submit the 6-digit code from the verification email.

Start a one-tap connect for a brand on an OAuth or app-password network (networks marked coming soon in list_networks are refused). Returns connect_url: give it to the account owner to open once. Then poll get_connect_status.

Card checkout for a human (coming soon): returns a Stripe-hosted checkout_url for a credit pack (pack_5 $5, pack_20 $20, pack_100 $100; each pack buys exactly its price in credit). Give the link to the person paying; credits arrive only after Stripe confirms. Verified owners, admin key. 503 checkout_not_enabled until switched on.

Schedule a post to one or more channels. idempotency_key is required; retries with the same key never double-post or double-charge. Optional max_price_usd refuses a price above your cap. Preview: posts are validated and priced in the sandbox, not published yet.

Disconnect a channel: erases its stored credentials and revokes the provider token where the network supports it.

Posts, deliveries, published, failed and spend over time (UTC), with a per-brand breakdown.

Status of a connect session: pending, connected (with channel_id), failed or expired.

Onboarding status: verification state, remaining steps and the exact next call. Start here after signup.

Surgemesh prices: base per delivery, a hard ceiling (never more than $0.06 per delivery), time-of-day pricing (quieter times cost less, busier times cost more), credit packs. No auth needed.

Exact price quote (locks at post acceptance; guard with max_price_usd) for N deliveries at scheduled_at (ISO 8601 UTC, e.g. 2026-10-29T15:00:00Z), or for a network mix (networks, e.g. {"bluesky": 1, "facebook": 2}; adds by_network), with cheaper_times (nearby times and their exact prices) when a nearby time costs less. No auth needed.

Your referral code, share link and stats (referred signups, qualified, credits earned and pending). Referral rewards are Surgemesh credits only, never cash, and are coming soon; codes can be shared now. Verified owners only.

Coming soon (payments are not enabled yet). Payment link to buy a credit pack (pack_5 $5, pack_20 $20, pack_100 $100; each pack buys exactly its price in credit). Rails: mpp_card (card via Stripe Shared Payment Token), mpp_stablecoin (USDC.e on Tempo, USDC on Solana), x402 (USDC on Base); each shows live or coming_soon. POST to paymentLink with your Bearer key, pay the 402 challenge, retry. No payment happens in this tool.

Account: plan, verification, credit, sandbox allowance (monthly_allowance, posts_used_this_month, posts_remaining_this_month, resets_at) and settings.

Status of one verification (pending, verified, expired, failed, denied).

Brands in this account.

Channels this key can post to (connected social accounts and sandbox test channels). Disconnected channels are hidden unless include_disconnected is true.

Every supported network: status (available, connect_pending_review, connect_pending_setup = coming soon), how to connect it, and the limits enforced on every post (text, hashtags, media count, types, sizes), plus the built-in sandbox test channel. No auth needed.

Recent posts for a brand: status (pending, accepted, rejected, cancelled), cancelled, sandbox, price_usd (quoted), charged_usd, per-channel delivery state.

Payments are not open yet. Ask for one email when they open (topic "payments_open"). With a key, the account owner's email is used; without a key, send email and accept_terms: true. Re-asking is safe (already: true, no duplicate). Optional intended_pack says which pack you plan to buy. One email, then the address is deleted 30 days later; the email has a one-click unsubscribe.

Email the account owner a one-tap Approve link (24 h, single use). Poll get_verification until verified or denied.

Rotate the calling key: returns a new key (shown once) with the same scopes; the old key keeps working for grace_seconds (default 3600, 0 = revoke now).

Tell Surgemesh what broke, confused you or is missing (no key needed; with a key the note is linked to your account). Include error_code and request_id from the response you got, and the tool or path as topic. The Surgemesh team reads every note; there is no reply. Never include secrets, keys or personal data.

Get a TXT record to publish on the account email domain (or a parent domain). Then call check_dns_verification.

Email a 6-digit code to the account email (expires in 10 minutes, 5 attempts). Then call confirm_email_verification with the code.

Account settings (admin key). trend_opt_out: true opts this account out of contributing to any aggregated trend statistics Surgemesh may create in future (see Terms); none exist today. get_usage shows the current setting.