API Overview

Version 1.00

All API methods require an HTTP User-Agent header and a token to execute. All requests without a user-agent header will fail with a 403 Forbidden HTTP response status code. A token is obtained by calling the authenticate method. Please check out the authentication method's documentation for instructions on its use.

If you wish to use the Meetingmax API to integrate with us, credentials must first be created by the Meetingmax licensee via the MCP application interface.

API Endpoint

https://mmxreservations.com/api/v1

Authenticate

This method assigns a token to be used for all other methods. Tokens are only active for 30 minutes, after which a new token must be acquired.

Arguments

key

required

This is the value provided to you within the MCP under the API tab.

systemIdentifier

required

The Meetingmax licensee number to create a token for.

Definition

https://mmxreservations.com/api/v1/authenticate

Example Request

$ curl https://mmxreservations.com/api/v1/authenticate /
   -d key=ABC123 /
   -d systemIdentifier=1

Example Response

{
  "token": "qt4oectadqdc6g4lalhezzk1pa5aa6iv"
}

Events

Events are core to Meetingmax. You can use the API to retrieve event information including the event name, address and start/end dates.

Get Event

This method retrieves the details for a given event.

Arguments

token

required

The token provided by the authenticate method.

eventId

required

The event ID to retrieve data for.

Definition

https://mmxreservations.com/api/v1/getevent

Example Request

$ curl https://mmxreservations.com/api/v1/getevent /
   -d token=qt4oectadqdc6g4lalhezzk1pa5aa6iv /
   -d eventId=14

Example Response

{
  "eventId": 14,
  "name": "Stanley Cup Finals",
  "city": "Vancouver",
  "state": "BC",
  "address": "800 Griffiths Way",
  "zip": "V6B 6G1",
  "startDate": "2020-02-04T00:00:00+00:00",
  "endDate": "2020-02-08T00:00:00+00:00",
  "cutOffDate": "2020-02-03T00:00:00+00:00"
}

Get Group Codes

This method will return all group codes for the specified event.

Arguments

token

required

The token provided by the authenticate method.

eventId

required

The event ID to retrieve data for.

Definition

https://mmxreservations.com/api/v1/getgroupcodes

Hotels

You may interact and retrieve information about your current hotel selection using the hotel methods here.

Get Hotels

This method retrieves the details of hotels that are currently assigned to an event.

Arguments

`token` required	The token provided by the authenticate method.
`eventId` required	The event ID to retrieve data for.
`simpleview` optional default: false	A boolean, if true, will respond with the Simpleview identifier for each hotel listed.
`hotelId` optional	This integer will filter the results by whichever hotel ID is provided.
`hotelName` optional	A string containing the hotel name to filter the results on.
`city` optional	String representing the city of the hotels to filter results on.
`state` optional	String representing the state or province to filter the hotel results on.
`status` optional	This is a string representing the current status of the hotels you would like returned as a result. By default, all statuses will be returned. Allowed statuses are: `enabled` and `disabled`.

Definition

https://mmxreservations.com/api/v1/gethotels

Reservations

When a customer books one or more rooms in the Meetingmax system, a new reservation object is created. Reservations objects can be looked up through the API method below.

Get Group Code Link

This method generates the link to make a reservation for an event specific to a group code for its special inventory.

Arguments

`token` required	The token provided by the authenticate method.
`eventId` required	The event ID to create the registration link for.
`groupCode` required	The group code that will be used to generate the reservation link for. This will allow access to its special inventory.
`attendeeId` required	The reference to the attendee to automatically populate fields in the registration process with.
`registrationEventId` required	The registration system's event ID that is associated with the provided attendee ID.

Definition

https://mmxreservations.com/api/v1/getgroupcodelink

Get Edit Reservation Link

Retrieves the link to edit a particular reservation based on the provided reservation number.

Arguments

token

required

The token provided by the authenticate method.

reservationNumber

required

The reservation number to retrieve the link for.

https://mmxreservations.com/api/v1/geteditreservationlink

Attendees

Attendees are those who end up making the reservations for your event. You can get attendee information and anything presented to attendees (like questions) through this API.

Post Attendee

This method creates an attendee in the Meetingmax system which is then used to pre-populate fields during the registration process. This method is also used to perform updates on existing attendees (as long as the attendee ID and registration event ID match a record in the system).

Due to the Meetingmax personal information policy, the data provided through this API call will be scrubbed from the system 90 days after the event it's attached to has ended, or 90 days after the last time that this record has been updated.

Arguments

`token` required	The token provided by the authenticate method.
`attendeeId` required	The attendee ID that is assigned to the registration. This ID is an external value that is used to reference the attendee in original system.
`registrationEventId` required	This is the event ID assigned to the registration in the registration system. This ID is an external value provided by the registration system and should not be confused with a Meetingmax event ID.
`updateReservation` optional default: false	When updating an existing attendee, this parameter can be used to push the data to the linked reservation, if one exists.
`email` optional	The email address for the contact.
`ccemail` optional	The contact's credit card email address (use a comma-separated list for more than one).
`salutation` optional	The salutation for the contact.
`firstName` optional	The first name for the contact.
`lastName` optional	The last name for the contact.
`companyName` optional	The company name for the contact.
`address` optional	First line of the contact's address.
`address2` optional	Second line of the contact's address.
`city` optional	The city for the contact.
`state` optional	The state or province for the contact.
`zip` optional	The zip or postal code for the contact.
`country` optional	The country for the contact. This can be its full name, or be in either ISO2 or ISO3 format.
`phone` optional	The phone number for the contact.

Definition

https://mmxreservations.com/api/v1/postattendee