msocialDocs
Feeds for your website

Feeds for your website

The three public endpoints your website can use: events, news posts and newsletter signups.

Events feed

GET https://msocial.ie/api/feeds/your-slug/events returns a JSON array of upcoming events, soonest first, up to 200. No key is needed and any website can read it.

Each event has id, title, start (an ISO date and time) and type, and may have type_label, motion, location, speaker, summary, url and image. Empty fields are left out.

Responses may be cached for up to five minutes. An unknown slug answers 404 with feed_not_found.

News posts feed

GET https://msocial.ie/api/feeds/your-slug/posts returns the workspace's published news articles, newest first, up to 60. Articles come from LinkedIn posts when LinkedIn news is switched on in Settings.

Each article has id, slug, title, images, published_at, author and feed, and may have cover_image and source_url. Most carry excerpt and body_html, ready to place on the page.

An article marked external: true carries the original post as plain text instead. Show it as a card that links to source_url.

Responses may be cached for up to ten minutes.

Newsletter signups

POST https://msocial.ie/api/feeds/your-slug/newsletter with a JSON body of email and, optionally, source (up to 64 characters, such as the page the form is on). It answers {"ok": true}, whether or not the address was already on the list.

  • 400 invalid_body: the email is missing or not valid.
  • 404 feed_not_found: the slug does not exist.
  • 429 rate_limited: more than 10 signups from one address in an hour. Try again later.