TagMangoTagMango Docs
Feed

Create Feed Post

POST
/api/v1/external/feeds/posts

Publish a new post to one or more of the creator's mangoes. Supports text, image, and video; images and videos must reference a pre-uploaded TagMango CDN asset. 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.

Response Body

application/json

application/json

application/json

application/json

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",
  "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_USER_ASSET_NOT_FOUND",
  "message": "The content URL must be a TagMango CDN URL with an existing userAsset record. Upload the file via the TagMango upload API first.",
  "result": "The content URL must be a TagMango CDN URL with an existing userAsset record. Upload the file via the TagMango upload API first.",
  "success": false
}
{
  "code": 401,
  "type": "Unauthorized",
  "statusMessage": "UNAUTHORIZED",
  "message": "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
}

Get Feed Posts GET

Get all the posts for a creator or subscriber. - If accessed on behalf of a subscriber, posts will be filtered based on active subscription for the mangoes in the post. - If accessed on behalf of a creator, posts will be filtered based on the creator. - If accessed without any parameters, all the posts will be returned for the creator.

Get Points For All Users GET

Get points for all users based on mangoes with gamification enabled