Surgemesh

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.

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

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.

Brands in this account.

无需输入参数。

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.

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

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

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.

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.

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.

无需输入参数。

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

无需输入参数。

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.

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

无需输入参数。

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

Submit the 6-digit code from the verification email.

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

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

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

Status of one verification (pending, verified, expired, failed, 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).

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.

无需输入参数。

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.

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

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.