TagMango Documentation

Publish a new post to one or more of the creator's mangoes, or repost an existing one via postRef. Supports text, image, and video. For image/video, contentUrl can be a URL already registered through a TagMango Cloud upload, or a fresh one — this endpoint registers it automatically if it is not one already, so image compression and video transcoding still work. Scheduling is optional — future scheduleTime hides the post from the feed until publish.

Authorization

bearer

AuthorizationBearer <token>

In: header

Header Parameters

x-whitelabel-host*string

Host name of the dashboard, ex: mydomain.tagmango.com

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

mangoes*array<>

Mango IDs the post is published to. Must be non-empty; all must belong to the creator.

excludeMangoes?array<>

Mango IDs explicitly excluded — hides the post from subscribers of these mangoes even when they appear in mangoes.

contentType*string

text requires caption and forbids contentUrl; image and video require contentUrl (TM-CDN URL of an uploaded userAsset).

Value in"video" | "image" | "text"

caption?string

Post body text. Required for text posts; optional for image and video.

contentUrl?string

Required for image and video posts, ignored for text. If this URL was already registered through a TagMango Cloud upload, that existing record is reused as-is (scoped to this creator). Otherwise a bare-bones record is created for it automatically — this is what lets image compression and video transcoding still work. Must resolve to a public host — internal, private, and loopback addresses are rejected.

scheduleTime?string

ISO-8601 publish time. Past or omitted = publish immediately. Future = post is hidden from the feed until that time.

postRef?object

Id of an existing, non-deleted post to repost. Not scoped to this creator — any existing post can be reposted, the same as internally. Can be combined with caption on top of it. A poll can never be a repost — polls are created through the separate /feeds/polls endpoint, which has no postRef field, matching legacy poll-creation behavior.

Response Body

`application/json`

curl -X POST "https://api-prod-new.tagmango.com/api/v1/external/feeds/posts" \  -H "x-whitelabel-host: string" \  -H "Content-Type: application/json" \  -d '{    "mangoes": [      "64fbc8d765c6e5b324d45678"    ],    "contentType": "text"  }'

{
  "createdAt": "2024-11-04T13:05:43.799Z",
  "updatedAt": "2024-11-04T13:05:43.799Z",
  "_id": "64fbc8d765c6e5b324d12345",
  "creator": "64fbc8d765c6e5b324d12345",
  "scheduleTime": "2025-01-25T12:30:00Z",
  "caption": "Learn the basics of Mango in this video.",
  "contentType": "video",
  "contentUrl": "https://example.com/video.mp4",
  "compressedVideoUrl": "https://example.com/compressed-video.mp4",
  "thumbnail": "https://example.com/thumbnail.jpg",
  "isCompressDone": false,
  "shortUrl": "shorturl.com/abc123",
  "compressedVideoUrlDash": "https://example.com/dash-video.mp4",
  "compressedVideoUrlHls": "https://example.com/hls-video.m3u8",
  "postRef": "64fbc8d765c6e5b324d65432",
  "postRefContentType": "image",
  "mangoes": [
    {
      "_id": "66a1390268a76f2f5c9f39a3",
      "title": "Introduction to Coding"
    }
  ],
  "excludeMangoes": [
    {
      "_id": "66a1390268a76f2f5c9f39a3",
      "title": "Introduction to Coding"
    }
  ],
  "thumbnail800": "https://example.com/800x800.jpg",
  "thumbnailBlurred500": "https://example.com/500x500_blr.jpg",
  "thumbnail235": "https://example.com/235x150.jpg"
}

{
  "code": 400,
  "type": "Bad Request",
  "statusMessage": "BAD_REQUEST",
  "errorCode": "POST_REPOST_NOT_FOUND",
  "message": "The `postRef` id must reference an existing, non-deleted post.",
  "result": "The `postRef` id must reference an existing, non-deleted post.",
  "success": false
}

{
  "code": 401,
  "type": "Unauthorized",
  "statusMessage": "UNAUTHORIZED",
  "message": "Invalid token",
  "result": "Invalid token",
  "success": false
}

{
  "code": 403,
  "type": "Forbidden",
  "statusMessage": "FORBIDDEN",
  "errorCode": "POST_CREATOR_NOT_FOUND",
  "message": "The creator associated with the API key does not exist.",
  "result": "The creator associated with the API key does not exist.",
  "success": false
}

{
  "code": 404,
  "type": "Not Found",
  "statusMessage": "NOT_FOUND",
  "errorCode": "POST_MANGOES_NOT_FOUND",
  "message": "One or more mango IDs in the request do not exist or have been deleted.",
  "result": "One or more mango IDs in the request do not exist or have been deleted.",
  "success": false
}

{
  "code": 429,
  "type": "Too Many Requests",
  "statusMessage": "TOO_MANY_REQUESTS",
  "message": "Request limit exceeded. try after 10 seconds",
  "result": "Request limit exceeded. try after 10 seconds",
  "success": false
}

Create Feed Post

Authorization

Header Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

404application/json

429application/json

POST_CREATOR_NOT_FOUND

POST_MANGOES_FORBIDDEN

POST_VIDEO_UPLOAD_NOT_ENABLED

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`