TagMango DocsFeed
Create Feed Poll
Create a poll post on one or more of the creator's mangoes — a poll is its own kind of post, created through this dedicated endpoint rather than as a field on create-post. A poll can never be a repost — there is no postRef field here, matching the underlying poll-creation behavior, which has never supported it. Voting and vote-result endpoints are not part of this API yet — this endpoint only covers creation.
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
application/json
curl -X POST "https://api-prod-new.tagmango.com/api/v1/external/feeds/polls" \ -H "x-whitelabel-host: string" \ -H "Content-Type: application/json" \ -d '{ "mangoes": [ "64fbc8d765c6e5b324d45678" ], "question": "Which feature should we build next?", "pollOptions": [ { "optionType": "text", "optionContent": "Option 1", "optionNumber": 1 } ], "endAt": "2026-08-28T09:24:46.458Z" }'{
"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",
"shortUrl": "shorturl.com/abc123",
"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",
"poll": {
"_id": "64fbc8d765c6e5b324d12345",
"question": "Which feature should we build next?",
"description": "Pick the one you would use the most.",
"pollOptions": [
{
"optionContent": "string",
"optionNumber": 0,
"optionId": "string"
}
],
"pollStartAt": "2026-01-28T07:47:29.862Z",
"pollEndAt": "2026-02-04T07:47:29.862Z",
"voteCounts": {
"k3j8x2q": 0,
"m91plaz": 0
},
"totalVotes": 0
}
}{
"code": 400,
"type": "Bad Request",
"statusMessage": "BAD_REQUEST",
"success": false,
"message": "Invalid request",
"result": "Invalid request"
}{
"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
}