Docs/Models

SocialPost

object

A social post created through the Fountain API.

A post targeting one connected SocialChannel. A post starts as a DRAFT; the publish option on Update Social Post then approves it, schedules it, or publishes it immediately.

Fields

_idstringrequired

Unique post identifier.

contentobjectrequired

The post body and attached media.

contextstringrequired

Context on why this post is recommended. Markdown. Fountain uses it when surfacing the post as a candidate in the dashboard and in email digests.

titlestringrequired

A short title shown with candidate posts in the dashboard and email digests.

textstringrequired

The post text.

uploadsSocialPostUpload[]required

Attached media uploads.

metaobjectrequired

Ownership and lifecycle metadata.

channelstringrequired

The channel the post belongs to.

createdstringrequired

ISO-8601 creation time.

updatedstringrequired

ISO-8601 last-update time.

syncedstringoptional

ISO-8601 time of last stats sync with the native platform.

scheduledstringoptional

ISO-8601 scheduled publish time, when scheduled.

publishedstringoptional

ISO-8601 publish time, once published.

statusSocialPostStatusrequired

The lifecycle state.

platformobjectrequired

The target platform and its post identifier.

typeSocialPlatformrequired

The platform the post targets.

idstringoptional

The platform-side post id, once published.

sourceSocialPostMediaSourceoptional

The content segment the post was cut from, when the post is tied to Fountain content.

statsSocialPostStatsoptional

Engagement figures for a published social post.

Example

{
  "_id": "p1q2r3s4t5u6",
  "content": {
    "context": "## Why this post\n\nBitcoin price went above $100,000, and this is generating a lot of engagement on X. The latest episode had John Doe, who discussed the effect of Bitcoin price fluctutations.",
    "title": "Bitcoin price increase",
    "text": "Bitcoin just hit $100,000. Check out my latest episode on why that matters.",
    "uploads": []
  },
  "meta": {
    "channel": "a1b2c3d4e5f6",
    "created": "2026-06-01T12:00:00.000Z",
    "updated": "2026-06-01T12:00:00.000Z",
    "synced": "2026-06-02T12:00:00.000Z",
    "published": "2026-06-01T12:00:05.000Z",
    "status": "PUBLISHED"
  },
  "platform": {
    "type": "x",
    "id": "1789012345678901234"
  },
  "source": {
    "ids": [
      "episode:id:abc123",
      "show:id:xyz789"
    ],
    "media": "https://media.fountain.fm/episodes/abc123.mp3",
    "transcript": "the genesis block was mined in 2009",
    "ts_start": 2477.91,
    "ts_end": 2493.9
  },
  "stats": {
    "views": 1240,
    "likes": 87,
    "comments": 12
  }
}

Example

{
  "_id": "p1q2r3s4t5u6",
  "content": {
    "context": "## Why this post\n\nBitcoin price went above $100,000, and this is generating a lot of engagement on X. The latest episode had John Doe, who discussed the effect of Bitcoin price fluctutations.",
    "title": "Bitcoin price increase",
    "text": "Bitcoin just hit $100,000. Check out my latest episode on why that matters.",
    "uploads": []
  },
  "meta": {
    "channel": "a1b2c3d4e5f6",
    "created": "2026-06-01T12:00:00.000Z",
    "updated": "2026-06-01T12:00:00.000Z",
    "synced": "2026-06-02T12:00:00.000Z",
    "published": "2026-06-01T12:00:05.000Z",
    "status": "PUBLISHED"
  },
  "platform": {
    "type": "x",
    "id": "1789012345678901234"
  },
  "source": {
    "ids": [
      "episode:id:abc123",
      "show:id:xyz789"
    ],
    "media": "https://media.fountain.fm/episodes/abc123.mp3",
    "transcript": "the genesis block was mined in 2009",
    "ts_start": 2477.91,
    "ts_end": 2493.9
  },
  "stats": {
    "views": 1240,
    "likes": 87,
    "comments": 12
  }
}

Fields

_idstringrequired

Unique post identifier.

contentobjectrequired

The post body and attached media.

contextstringrequired

Context on why this post is recommended. Markdown. Fountain uses it when surfacing the post as a candidate in the dashboard and in email digests.

titlestringrequired

A short title shown with candidate posts in the dashboard and email digests.

textstringrequired

The post text.

uploadsSocialPostUpload[]required

Attached media uploads.

metaobjectrequired

Ownership and lifecycle metadata.

channelstringrequired

The channel the post belongs to.

createdstringrequired

ISO-8601 creation time.

updatedstringrequired

ISO-8601 last-update time.

syncedstringoptional

ISO-8601 time of last stats sync with the native platform.

scheduledstringoptional

ISO-8601 scheduled publish time, when scheduled.

publishedstringoptional

ISO-8601 publish time, once published.

statusSocialPostStatusrequired

The lifecycle state.

platformobjectrequired

The target platform and its post identifier.

typeSocialPlatformrequired

The platform the post targets.

idstringoptional

The platform-side post id, once published.

sourceSocialPostMediaSourceoptional

The content segment the post was cut from, when the post is tied to Fountain content.

statsSocialPostStatsoptional

Engagement figures for a published social post.

{ "_id": "p1q2r3s4t5u6", "content": { "context": "## Why this post\n\nBitcoin price went above $100,000, and this is generating a lot of engagement on X. The latest episode had John Doe, who discussed the effect of Bitcoin price fluctutations.", "title": "Bitcoin price increase", "text": "Bitcoin just hit $100,000. Check out my latest episode on why that matters.", "uploads": [] }, "meta": { "channel": "a1b2c3d4e5f6", "created": "2026-06-01T12:00:00.000Z", "updated": "2026-06-01T12:00:00.000Z", "synced": "2026-06-02T12:00:00.000Z", "published": "2026-06-01T12:00:05.000Z", "status": "PUBLISHED" }, "platform": { "type": "x", "id": "1789012345678901234" }, "source": { "ids": [ "episode:id:abc123", "show:id:xyz789" ], "media": "https://media.fountain.fm/episodes/abc123.mp3", "transcript": "the genesis block was mined in 2009", "ts_start": 2477.91, "ts_end": 2493.9 }, "stats": { "views": 1240, "likes": 87, "comments": 12 } }