TagMangoTagMango Docs
Mango

Get Mangoes

GET
/api/v1/external/mangos

Get all mangoes created by creator

Authorization

bearer
AuthorizationBearer <token>

In: header

Query Parameters

limit?number

Number of items per page of the results

Range1 <= value
page?number

Page number of the results

Range1 <= value

Header Parameters

x-whitelabel-host*string

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

Response Body

application/json

application/json

application/json

curl -X GET "https://api-prod-new.tagmango.com/api/v1/external/mangos" \  -H "x-whitelabel-host: string"
[
  {
    "_id": "66a1390268a76f2f5c9f39a3",
    "creator": "77b2390268a76f2f5c9f39a4",
    "title": "Introduction to Coding",
    "price": 500,
    "currency": "USD",
    "inrAmount": 500,
    "usdAmount": 6,
    "eurAmount": 5,
    "description": "This is a comprehensive guide to coding.",
    "isHidden": false,
    "isDeleted": false,
    "recurringType": "MONTHLY",
    "isPublic": false,
    "isFree": true,
    "affiliateEnabled": true,
    "zeroCostMango": false,
    "createdAt": "2024-08-11T10:20:30Z",
    "updatedAt": "2024-08-11T10:20:30Z",
    "coverContents": [
      "https://linktoimage.com/image.jpg",
      "https://linktoimage.com/video.mp4"
    ]
  }
]
{
  "code": 400,
  "type": "Bad request",
  "statusMessage": "BAD_REQUEST",
  "message": "Invalid request",
  "success": false
}
{
  "code": 401,
  "type": "Unauthorized",
  "statusMessage": "UNAUTHORIZED",
  "message": "Invalid token",
  "success": false
}

Update Landing Page PUT

Update an existing landing page owned by the authenticated creator. - Only the page owner can update; otherwise returns 404. - When `editorState` is provided, it is re-uploaded to S3 and the stored URL is updated. - `customSlug` must be unique within the host. A `400 Bad Request` is returned on conflict. - The `mango` binding is immutable via this endpoint — delete and recreate if it must change.

Create Mango POST

Create a new service (mango) for the creator. **Types:** `onetime` (single purchase), `recurring` (subscription), `free` (no payment). **Pricing:** Base price in creator's currency. For INR creators, minimum is ₹50. When `differentialPricing` is omitted, USD/EUR prices are auto-converted using real-time exchange rates. **Validation rules:** - `free` type must not include `price`, `differentialPricing`, or `includeGST`. - `recurring` type requires `recurringType` (monthly, quarterly, halfyearly, yearly). - `onetime` type must not include `recurringType`. - HTML tags are stripped from `title` and `description`.