Introduction
Marsial is an API and a dashboard for social publishing. You connect a brand’s accounts (or your customers’) once and from then on you publish, schedule, answer comments and messages and measure results on all of them in the same format.
How it is organised
Section titled “How it is organised”Everything hangs off three objects, the same in the API and the dashboard:
- Profile (
prf_…): a brand or a customer. It groups their accounts, their queue and their time zone. - Account (
acc_…): a social account connected to a profile, for example Acme’s Instagram. - Post (
pst_…): text with images or videos that goes out on one or several accounts, each with its own options.
What you do in the dashboard shows in the API and the other way round: if your team schedules a post from the dashboard, your integration gets the webhook just like for its own. Details in Concepts.
The API in one line
Section titled “The API in one line”- Base URL:
https://api.marsial.dev/v1 - Authentication:
Authorization: Bearer <your API key>(how to get one). - Format: JSON. Responses come in
data; errors inerror, with a stablecode(errors). - Dates: ISO 8601 with a time zone, e.g.
2026-10-30T09:00:00+01:00. - OpenAPI document:
/openapi.json, to generate clients or import into Postman.
Networks
Section titled “Networks”| Network | What it publishes | Comments | Mentions | Direct messages | Reviews |
|---|---|---|---|---|---|
| Feed, reels, stories and carousels | Yes | Yes, and they can be answered | Yes | — | |
| Pages: feed, reels and stories | Yes | — | Yes | Yes | |
| TikTok | Videos | Yes | — | — | — |
| YouTube | Videos and Shorts | Yes | — | — | — |
| Profiles and pages | Yes | Yes (pages) | — | — | |
| X | Posts and threads | Yes | — | Yes (unencrypted) | — |
| Threads | Posts and threads | Yes | — | — | — |
| Bluesky | Posts and threads | Yes | — | Yes | — |
| Pins | — | — | — | — | |
| Posts in subreddits | — | — | — | — | |
| Snapchat | Stories and Spotlight of the public profile | — | — | — | — |
| Telegram (soon) | Messages in channels and groups | — | — | Yes | — |
| Discord | Messages in channels | — | — | — | — |
| Slack | Channel messages | — | — | Yes | — |
| Templates and broadcasts (no posts) | — | — | Yes | — | |
| Google Business | Business profile posts | — | — | — | Yes |
| WordPress | Blog articles (WordPress.com and self-hosted) | — | — | — | — |
| Shopify | Store blog articles | — | — | — | — |
| Wix | Blog articles | — | — | — | — |
| Webflow | CMS collection items | — | — | — | — |
HubSpot does not publish: connected to a profile, it turns the people who write to its inbox into HubSpot contacts and logs every message on their record. Set it with PATCH /v1/accounts/{id}/crm-settings (syncContacts, logMessages). |
Ads: Meta, Google, LinkedIn, TikTok, Pinterest, X and Reddit Ads connect as ads accounts (meta-ads…) to see campaigns, pause them, change budgets and boost posts. See Ads.
Analytics (followers, engagement, best times) are read per profile or per account.
© 2026 Marsial by TWOFACES ·marsial.dev ·Dashboard ·soporte@twofacesco.com