TagMango Documentation

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.

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.

title*string

Service title. HTML tags are stripped. Max 100 characters.

Lengthlength <= 100

description*string

Description of the service. Supports markdown. Displayed on the checkout page.

coverContents?array<>

Cover content URLs (images and/or videos) for the service checkout page. All URLs are stored as cover content.

type*string

Service pricing model. recurring type requires recurringType. free type must not include price, differentialPricing, or includeGST.

Value in"onetime" | "recurring" | "free"

recurringType?string

Billing interval for recurring subscriptions. Required when type is recurring. Must NOT be sent for other types.

Value in"monthly" | "yearly" | "quarterly" | "halfyearly"

price?number

Base selling price in the creator's currency.

Required when type is onetime or recurring. Must NOT be sent for free.

Minimum: ₹50 for INR creators, $1/€1 for USD/EUR creators.

When differentialPricing is not provided, the system auto-converts this price to INR/USD/EUR using real-time exchange rates.

Range1 <= value

differentialPricing?

Per-currency price overrides for international checkout.

When omitted, the system auto-converts the base price to all supported currencies using real-time exchange rates.

Must NOT be sent when type is free.

settings?

Service checkout settings.

Response Body

`application/json`

curl -X POST "https://api-prod-new.tagmango.com/api/v1/external/mangos" \  -H "x-whitelabel-host: string" \  -H "Content-Type: application/json" \  -d '{    "title": "Premium Fitness Course",    "description": "A 12-week fitness transformation program.",    "type": "onetime"  }'

{
  "_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",
  "errorCode": "MANGO_TITLE_RESERVED",
  "message": "The title \"public\" is reserved and cannot be used as a mango name.",
  "result": "The title \"public\" is reserved and cannot be used as a mango name.",
  "success": false
}

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

{
  "code": 403,
  "type": "Forbidden",
  "statusMessage": "FORBIDDEN",
  "errorCode": "MANGO_USER_NOT_CREATOR",
  "message": "The user has not completed creator onboarding or is not on a host platform that allows mango creation.",
  "result": "The user has not completed creator onboarding or is not on a host platform that allows mango creation.",
  "success": false
}

{
  "code": 404,
  "type": "Not Found",
  "statusMessage": "NOT_FOUND",
  "errorCode": "MANGO_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
}

Create Mango

Authorization

Header Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

404application/json

MANGO_TITLE_RESERVED

MANGO_TIER_UPSELL_RESTRICTED

MANGO_ZERO_COST_PAID_CONFLICT

MANGO_OFFSHORE_PINCODE_REQUIRED

MANGO_USER_NOT_CREATOR

MANGO_FREEBIE_NOT_OWNED

MANGO_FUNNEL_NOT_OWNED

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`