APIs
API Overview
The Mango9 API allows you to programmatically access and manage your account features, make calls, send messages, manage calendar events, and integrate with your existing systems.
Calendar API - Create Event
Your API Key: a1b2c3d4e5f67
Keep your API key secure and never share it publicly
Endpoint
POST https://us.mango9.com/calendar_api
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| apiKey | String | Yes | Your API key for authentication |
| start | Object | Yes | Event start details including dateTime and timeZone |
| end | Object | Yes | Event end details including dateTime and timeZone |
| summary | String | No | Title of the event |
| description | String | No | A detailed explanation of the event |
| activity | String | No | Activity type: "task", "appointment", "follow up call" |
| priority | String | No | Priority level: "high", "medium", "low" |
| reminders | Object | No | Reminder methods: "email", "sms", "both" with minutes before event |
Request Example
Sample Response
Error Codes
| Status | Code | Description |
|---|---|---|
| Success | 00 | Operation completed successfully |
| Error | 01 | No API Key Provided - Missing API key |
| Error | 02 | Wrong API Key - Invalid API key |
| Error | 03 | Start Date Could Not Be Empty - Missing start field |
| Error | 04 | End Date Could Not Be Empty - Missing end field |
| Error | 05 | Time Zone Could Not Be Empty - Missing timeZone field |
| Error | 400 | The specified time range is empty / Invalid request payload |
| Error | 401 | Invalid Credentials |
| Error | 500 | Backend Error |
| Busy | 200 | No free slots available today / Event scheduled outside business hours |
Contacts API - Create New Lead
Your API Key: x9y8z7w6v5u43
Keep your API key secure and never share it publicly
Endpoint
POST https://us.mango9.com/contacts_api
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | String | Yes | The unique API key for authentication |
| contact | String | Yes | The contact number of the individual |
| name | String | Yes | The full name of the contact person |
| String | No | The email address of the contact person | |
| city | String | No | The city where the contact person resides |
| state | String | No | The state where the contact person resides |
| zip | String | No | The ZIP code associated with the contact person |
| country | String | No | The country where the contact person resides |
| group_id | String | No | The group ID associated with the contact person |
| note | String | No | Information about the lead that the company leaves behind |
| Custom Fields | Varies | No | Additional fields for specifying custom attributes and values |
Request Example
Sample Response
Error Codes
| Status | Code | Description |
|---|---|---|
| Success | 00 | New contact has been added successfully! |
| Error | 01 | No API Key Provided - Missing API key |
| Error | 02 | Wrong API Key - Invalid API key |
| Error | 03 | First name could not be empty - Missing name field |
| Error | 04 | Last name could not be empty - Missing name field |
| Error | 05 | Contact number could not be empty - Missing contact field |
| Error | 97 | The number you want to add already exists! |
| Error | 99 | An error occurred, Please contact the administrator! |
| Error | 401 | Invalid Credentials |
| Error | 500 | Backend Error |
SMS API - Send Text Messages
Your API Key: k8j7h6g5f4d32
Keep your API key secure and never share it publicly
Endpoints
POST https://us.mango9.com/app/smsapi/sms/post
GET https://us.mango9.com/app/smsapi/sms/get
We also offer a bulk HTTP interface for sending different messages to multiple recipients. We recommend no more than 500 contacts in each submission.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | String | Yes | Your API key for authentication |
| title | String | No | Optional campaign title (URL-encoded) |
| contacts | String | No | Comma-separated contact numbers (max 1000). Example: '69XXXXXX,67XXXXXX' |
| groupid | String | No | Optional group ID. If provided, overrides contacts parameter |
| senderid | String | Yes | Approved sender ID (phone number) |
| msg | String | Yes | URL-encoded SMS text (max 740 characters) |
| type | String | Yes | Type of SMS: "text" or "mms" |
| mms | File | No | Optional MMS file. Max size: 2MB |
| time | String | No | Scheduled time in format "YYYY-MM-DD H:I". Leave blank for instant SMS |
| time_zone | String | No | Time zone in "Country/City" format |
GET Request Example
Sample GET Response
POST Request Example
Sample POST Response
API Types
Text SMS API
Flash SMS API
Unicode SMS API
Delivery Reports API
Authentication
All API requests require authentication using an API key. Include your key in the Authorization header: