TagMango Documentation

Add a customer to any mango arbitrarily. The behaviour is the same as the "Add Customer" option on the customers page in the TagMango dashboard.

Important Notes

name, email, phone, and mangoId are required
If both validityDays and validUntil are provided, validUntil takes precedence
If dialCode is provided, it takes priority over country for determining the phone dial code

Authorization

apiKey

x-api-key<token>

Your TagMango API key from Dashboard > Automation > Platform Integrations

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Name of the customer being added

email*string

Email of the customer being added

Formatemail

phone*number

Phone number of the customer being added

mangoId*string

The ID of the mango/service the user is being added to. This ID can be found at Dashboard > Services.

coupon?string

If provided, must be a 100% discount coupon code which will be used to simulate the purchase flow. If not provided, a random ephemeral coupon code is used.

affiliate?string

Affiliate ID to associate with the migration (optional)

affiliateEmail?string

Affiliate email to associate with the migration (optional)

Formatemail

country?string

Country code of the customer (optional)

dialCode?string

Dial code for the phone number. If provided, takes priority over country for determining dial code.

validityDays?integer

Number of days from the current date for which the subscription will be valid. Must be a positive integer (>= 1). Cannot be used with validUntil — if both are provided, validUntil takes precedence.

Range1 <= value

validUntil?string

Expiry date for the subscription in DD/MM/YYYY or DD-MM-YYYY format. The date must be valid and cannot be in the past. Takes precedence over validityDays if both are provided.

Response Body

`application/json`

curl -X POST "https://api-prod-new.tagmango.com/integration/action/migrate-user" \  -H "Content-Type: application/json" \  -d '{    "name": "John Doe",    "email": "john@example.com",    "phone": 1900118822,    "mangoId": "66d0493aa0d85045eefbea89"  }'

{
  "code": 0,
  "type": "OK",
  "message": "Successfully loaded data",
  "result": {
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "1234567890",
    "country": "IN",
    "status": "Success",
    "orderId": "634fc35ddaf58580e2418c40",
    "subscriptionId": "634fc35ddaf58580e2418c40",
    "userId": "634fc35ddaf58580e2418c40",
    "errorMessage": "None"
  }
}

{
  "code": 500,
  "type": "InternalServerError",
  "message": "Something went wrong",
  "result": null
}

Empty

Migrate User

Important Notes

Authorization

Request Body

Response Body

200application/json

400application/json

401

`application/json`

`application/json`