API reference

Every endpoint of the Marsial API, generated from the OpenAPI document. Base URL: https://api.marsial.dev/v1 · OpenAPI document (JSON)

PostsPublish now, schedule, queue or save drafts to one or many accounts. (14 endpoints)

MediaUpload images and videos to Marsial before posting them. (1 endpoint)

ProfilesA profile is one brand or end customer. Social accounts are connected to a profile. (5 endpoints)

ConnectConnect a social account or a site: send the user to the URL, Marsial brings them back to your redirectUrl. (4 endpoints)

AccountsConnected social accounts, whether they can post, and their boards, playlists and subreddits. (8 endpoints)

Account groupsSaved selections of accounts, to post to them together. (4 endpoints)

BlogsArticles on WordPress, Shopify, Wix and Webflow sites: list, draft, schedule, publish, update and delete. These accounts take articles, not posts. (6 endpoints)

QueueRecurring weekly slots per profile. Posts sent with `queue: true` take the next free one. (3 endpoints)

InboxDirect messages, comments and reviews of a profile’s accounts. Lists take the profile; actions take the account the item belongs to. (15 endpoints)

WhatsappWhatsApp Business numbers: templates Meta reviews, writing first with an approved template (POST /inbox/conversations) and broadcasts to many numbers. Replies inside 24 hours go through the inbox. These accounts take no posts. (7 endpoints)

AdsAd campaigns on Meta, Google, LinkedIn, TikTok, Pinterest, X and Reddit through an ads connection (platform `meta-ads`, `google-ads`…): list them with spend and results, pause, resume, change budgets, boost published posts, create campaigns and send conversions. Budgets are whole currency units, never cents. (9 endpoints)

Phone numbersPhone numbers for calls and SMS: browse countries and prices, buy one (countries that regulate numbers ask for the registrant's identity first: KYC), set where inbound calls go and turn SMS on. Owners and admins manage them; numbers bill monthly from the balance. (11 endpoints)

CallsCall from your numbers (Marsial rings the person and connects them with your phone, a SIP address or an AI voice agent), read the call history with recordings and transcripts, and estimate what a call costs. (7 endpoints)

SmsSend SMS and MMS from your numbers. Replies arrive in the inbox (platform `sms`) and as `message.received` events. (2 endpoints)

AutomationsComment-to-DM: when someone comments a keyword, answer with a private message (Instagram, Facebook) or a public reply (every network). (6 endpoints)

AnalyticsFollowers, daily totals, best times to post and top posts, per profile or per account. (4 endpoints)

WebhooksReceive Marsial events at your HTTPS endpoint. (4 endpoints)

WorkspaceYour workspace and who is calling. (3 endpoints)

TeamMembers and invitations. Owners and admins manage the team; members publish and answer. (6 endpoints)

BillingA free trial, then a prepaid balance. New workspaces publish for free for 7 days from their first published post (14 days at most from signing up); X and phone numbers need balance. After the first top-up, connected accounts are charged day by day and usage (X API, messages, phone numbers, calls, SMS) as it happens. Topping it up happens in the dashboard. (5 endpoints)

Api keysManage API keys. Only from the dashboard, so a leaked key cannot mint new ones. (3 endpoints)

AgentsAI agents connected through the MCP server (OAuth). The dashboard approves and disconnects them; agents use https://api.marsial.dev/mcp. (5 endpoints)