Social Networks Integration

Last updated: Aug 31, 2026Section: Integrations

Use a SOCIAL integration to compose posts in the Mailoo dashboard and publish them to X and/or Facebook. Credentials stay on the server; only project owners can edit connections.

Create the integration

  1. Open your project → Integrations → Add integration.
  2. Choose Social networks (type SOCIAL).
  3. After creation, open Connection & settings and add channel credentials.

Connection & settings

Enable one or both channels and save:

X (Twitter)

  • Bearer token (OAuth 2 API v2)

Facebook

  • Page access token (Graph API)
  • Facebook Page ID (numeric)

Tokens are stored encrypted on the integration. They are never returned in plain text to the client after save. Only the project owner can edit social connections; editors can still manage posts when membership allows.

Compose and publish

Under the integration content view:

  1. Create a post with title and Markdown body (required).
  2. Optionally set intro, link URL, hashtags, featured image media id, and a schedule time (local time in the form).
  3. Choose channels (X and/or Facebook). By default both are enabled when you create a post; turn off any channel you do not want for that post.
  4. Save, then Publish now (or wait for the scheduled time). Use Repost to queue another attempt after a previous publish.

Publishing runs on the Mailoo server with retries. Refresh status in the dashboard to see per-channel results after each attempt.

What this is not

  • SOCIAL has no public webhook for external sites to submit posts with an API key. Composition and publish are dashboard (Bearer) flows.
  • MCP agents can create a SOCIAL integration via provisioning tools, but social post CRUD and publish are not MCP tools today.
  • images{.interpreted-text role="doc"} --- upload media and use media ids in posts
  • mailoo-mcp{.interpreted-text role="doc"} --- agent provisioning of integrations
  • OpenAPI at https://api.mailoo.app/docs/v1 for dashboard social routes
📚