TagMango Documentation

Create a new video call (webinar) for the creator.

Duration must be between 30 and 300 minutes (5 hours).
For one-time calls: provide startDate, fromTime, timezoneName, duration.
For recurring calls: also provide endDate, and repeatingDays for weekly.
Returns the created slot ID for one-time calls, or the list of scheduled date ranges for recurring.
Important: Run the check-availability endpoint first to confirm there are no overlapping calls before creating.

Authorization

bearer

AuthorizationBearer <token>

In: header

Header Parameters

x-whitelabel-host*string

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

x-timezone-offset*string

Timezone offset (in number) example-> 330

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

title*string

Title of the video call

description?string

mango*string

Comma-separated mango IDs to attach this call to (at least one required)

excludeMangoes?string

Comma-separated mango IDs whose subscribers should be excluded from notifications

recurringType?string

Default"onetime"

Value in"onetime" | "daily" | "weekly"

startDate*string

Start date in YYYY-MM-DD format

endDate?string

End date in YYYY-MM-DD format. Required for daily/weekly recurrence.

fromTime*string

Start time in HH:mm (24-hour) format

timezoneName*string

IANA timezone name

timezone?string

Timezone offset string, e.g. "+05:30"

duration*number

Duration in minutes. Must be between 30 and 300 (5 hours).

repeatingDays?array<>

Array of 7 values (0 or 1) for Sun–Sat. Required for weekly recurrence.

ongoingCallType?string

Ongoing call type: "webinar" or "meeting"

meetingUrl?string

Custom meeting URL. If omitted, a TagMango-hosted meeting is created.

thumbnail?string

Thumbnail image URL for the video call

mangoToSell?string

Mango ID to upsell during this video call

showGroupLinkForRecurringCall?boolean

enableRecordingZoomCall?boolean

autoUploadRecordingsEnabled?boolean

Response Body

`application/json`

curl -X POST "https://api-prod-new.tagmango.com/api/v1/external/workshops/video-calls" \  -H "x-whitelabel-host: string" \  -H "x-timezone-offset: string" \  -H "Content-Type: application/json" \  -d '{    "title": "Weekly Marketing Call",    "mango": "66c4964c11e7fef26751f3a7",    "startDate": "2025-06-01",    "fromTime": "10:00",    "timezoneName": "Asia/Calcutta",    "duration": 60  }'

{
  "_id": "66c4964c11e7fef26751f3a7",
  "scheduledMeetingDates": [
    "2025-06-02T04:30:00.000Z to 2025-06-02T05:30:00.000Z"
  ]
}

{
  "code": 400,
  "type": "Bad request",
  "statusMessage": "BAD_REQUEST",
  "message": "Invalid request",
  "success": false
}

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

Create Video Call

Authorization

Header Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`