GoTo Developer
Contact Support
API Status
Sign Up
Guides
Changelog
Partners
GoTo Developer
API docs by Redocly

GoTo Meeting REST API (1.0.0)

GoTo Meeting API Overview

The GoTo Meeting APIs provide:

  • Top-rated audio in the industry
  • A world-class online meeting app
  • Conference room support
  • Recordings and transcriptions (if turned on for the user account)
  • Complete reporting

The GoTo Meeting API suite lets you create and run interactive meeting sessions over the web or via a mobile device. Each session is created and moderated by one or more organizers. Once a meeting has been created and scheduled, attendees are invited and can R.S.V.P. for the meeting, saving the meeting invite to their Google or Outlook calendars.

At the scheduled time, the organizer starts the meeting. This launches a live, interactive meeting session; attendees who were logged in and waiting for the session to start are joined in automatically, and any new attendees join directly.

Joined Accounts

A GoTo Meeting account is the foundation for GoToWebinar and GoToTraining accounts, and therefore the GoToWebinar and GoToTraining API suites rely on the GoTo Meeting account and APIs. For example, while each product has a separate interface and log-in, anyone who has a GoToWebinar or GoToTraining account can log into and use GoToMeeting. As a developer, each product needs a separate API key, but you use one organizerKey for a user in each of the related applications.

A feature valuable to many GoTo Meeting users is the ability to enable OpenVoice Integrated toll-free audio services on the account. This is a low-cost means of adding up to 500 additional participants to an online event. They are limited to audio, but they can use the chat feature, and all users can, if the organizer chooses, view the names of the other participants.

Automate and Administer

The Administration API enables your admin users to manage users, groups and licenses; maintain custom data; create default product settings; and report extensively on scheduled and historic events; recording use; and on activity, usage, rates, and billing.

IMPORTANT: It is best practices to use the GoTo Admin API to manage users and groups (e.g., Create Organizers) for GoToMeeting, GoToWebinar, GoToTraining, and OpenVoice products. The similar API calls in these products work, but do not support multi-tiered accounts - those accounts with, for example, 25-seat and 100-seat product accounts in the same corporate account.

Refer to GoTo Meeting product documentation to review the meeting types and product functionality.

Review call bodies and example call bodies in the API calls for alternate usage.

Getting Started

  1. Register for a GoToDeveloper account.
  2. Create an OAuth client and include the product(s) you plan to develop with.
  3. Obtain a product account as needed. Trial versions will work, but last only 30 days. We recommend a full-featured account, preferably with an Admin role.
  4. Request an Access Token to make API calls.
  5. Make your first API calls. You can use cURL, Postman, or other API interfaces to make calls.

You can, once you have created an OAuth client, open product APIs as a collection in Postman (or an API development environment of your choice) and run the Get Authorization Code and then the Get Access Token calls from there.

Organizers

Operations on organizers. Only available to users with the admin role.

Create organizer Deprecated


DEPRECATED: To 'Create organizer', please use 'Add users' from the GoTo Admin API.

Creates a new organizer and sends an email to the email address defined in the request. This API call is only available to users with the admin role. You may also pass 'G2W', 'G2T', 'OPENVOICE', 'G2ASEEIT', 'G2ARS' or 'G2ASD' as productType variables, creating organizers for those products. A G2W or G2T organizer will also have access to G2M.

Please note that your client requires the Admin Center scope (identity:) to execute this API request.
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
Request Body schema: application/json

The details of the organizer to be created

organizerEmail
required
string

The email address of the organizer

firstName
string

The first name of the organizer

lastName
string

The surname of the organizer

productType
string (Product)
Enum: "G2M" "G2W" "G2T" "OPENVOICE" "G2ASEEIT" "G2ARS" "G2ASD"

Responses

Response Schema: application/json
Array
key
required
string^\d+$

The organizer's key

email
required
string

The organizer's email address

Request samples

Content type
application/json
{
  • "organizerEmail": "string",
  • "firstName": "string",
  • "lastName": "string",
  • "productType": "G2M"
}

Response samples

Content type
application/json
[
  • {
    }
]

Get organizer by email / Get all organizers Deprecated


DEPRECATED: To 'Get organizer by email / Get all organizers', please use 'Get users' from the GoTo Admin API.

Gets the individual organizer specified by the organizer's email address. If an email address is not specified, all organizers are returned. This API call is only available to users with the admin role.

Please note that your client requires the Admin Center scope (identity:) to execute this API request.
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
query Parameters
email
string

The email address of the organizer

Responses

Response Schema: application/json
Array
lastName
required
string

The organizer's surname

groupId
required
integer <int64>

The key of the group this organizer is assigned to

groupName
required
string

The name of the group this organizer is assigned to

status
required
string (Status)
Enum: "active" "suspended" "inactive"

The status of an organizer (or group), i.e. whether the organizer (or the members of the group respectively) are able to host meetings

organizerKey
required
integer <int64>

The key of the organizer

organizerkey
integer <int64>
Deprecated

The key of the organizer

email
required
string

The organizer's email address

firstName
required
string

The organizer's first name

products
Array of strings (Product)
Items Enum: "G2M" "G2W" "G2T" "OPENVOICE" "G2ASEEIT" "G2ARS" "G2ASD"
maxNumAttendeesAllowed
required
integer <int32>

The maximum number of attendees allowed at sessions hosted by this organizer.

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/organizers',
  params: {email: 'SOME_STRING_VALUE'},
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Delete organizer by email Deprecated


DEPRECATED: To delete organizer, please use 'Delete user' from the GoTo Admin API.

Deletes the individual organizer specified by the email address. This API call is only available to users with the admin role.

Please note that your client requires the Admin Center scope (identity:) to execute this API request.
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
query Parameters
email
required
string

The email address of the organizer

Responses

Request samples 

var axios = require("axios").default;

var options = {
  method: 'DELETE',
  url: 'https://api.getgo.com/G2M/rest/organizers',
  params: {email: 'SOME_STRING_VALUE'},
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Get organizer Deprecated


DEPRECATED: To 'Get organizer', please use 'Get users' from the GoTo Admin API.

Returns the individual organizer specified by the key. This API call is only available to users with the admin role. Non-admin users can only make this call for their own organizerKey.

Please note that your client requires the Admin Center scope (identity:) to execute this API request.
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
organizerKey
required
integer <int64>

The key of the organizer

Responses

Response Schema: application/json
Array
lastName
required
string

The organizer's surname

groupId
required
integer <int64>

The key of the group this organizer is assigned to

groupName
required
string

The name of the group this organizer is assigned to

status
required
string (Status)
Enum: "active" "suspended" "inactive"

The status of an organizer (or group), i.e. whether the organizer (or the members of the group respectively) are able to host meetings

organizerKey
required
integer <int64>

The key of the organizer

organizerkey
integer <int64>
Deprecated

The key of the organizer

email
required
string

The organizer's email address

firstName
required
string

The organizer's first name

products
Array of strings (Product)
Items Enum: "G2M" "G2W" "G2T" "OPENVOICE" "G2ASEEIT" "G2ARS" "G2ASD"
maxNumAttendeesAllowed
required
integer <int32>

The maximum number of attendees allowed at sessions hosted by this organizer.

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/organizers/%7BorganizerKey%7D',
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Delete organizer Deprecated


DEPRECATED: To 'Delete organizer', please use 'Delete user' from the GoTo Admin API.

Deletes the individual organizer specified by the organizer key. This API call is only available to users with the admin role.

Please note that your client requires the Admin Center scope (identity:) to execute this API request.
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
organizerKey
required
integer <int64>

The key of the organizer

Responses

Request samples 

var axios = require("axios").default;

var options = {
  method: 'DELETE',
  url: 'https://api.getgo.com/G2M/rest/organizers/%7BorganizerKey%7D',
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Update organizer Deprecated


DEPRECATED: To 'Update organizer', please use 'Update user' from the GoTo Admin API.

Updates the products of the specified organizer. To add a product ('G2W', 'G2T', 'OPENVOICE', 'G2ASEEIT', 'G2ARS', 'G2ASD') for the organizer, the call must be sent once for each product you want to add. To remove all products for the organizer, set status to 'suspended'. The call is limited to users with the admin role.

Please note that your client requires the Admin Center scope (identity:) to execute this API request.
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
organizerKey
required
integer <int64>

The key of the organizer

Request Body schema: application/json

The organizer's status

status
string
Value: "suspended"

The status of the organizer can be set to. Use 'suspended' to remove all products. The formerly used status 'active' is now DEPRECATED for this call. To activate the organizer please assign a product. In this case do not pass this parameter

productType
string (Product)
Enum: "G2M" "G2W" "G2T" "OPENVOICE" "G2ASEEIT" "G2ARS" "G2ASD"

Responses

Request samples

Content type
application/json
{
  • "status": "suspended",
  • "productType": "G2M"
}

Get attendees by organizer

Lists all attendees for all meetings within a specified date range for a specified organizer. This API call is only available to users with the admin role.

If you want to execute this for other organizers your client requires the Admin Center scope (identity:).
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
organizerKey
required
integer <int64>

The key of the organizer

query Parameters
startDate
required
string <date-time>

A required start of date range in ISO8601 UTC format, e.g. 2021-07-01T22:00:00Z

endDate
required
string <date-time>

A required end of date range in ISO8601 UTC format, e.g. 2021-07-01T23:00:00Z

Responses

Response Schema: application/json
Array
lastName
required
string

The surname of the meeting organizer

groupName
required
string

The name of the group the organizer is assigned to

numAttendees
required
integer <int32>

The number of attendees at the attended meeting instance

attendeeName
required
string

The full name of the attendee

subject
required
string

The subject of the attended meeting

endTime
string (AttendeesMeetingEndTime) ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$

The time the meeting instance ended, e.g. 2021-07-01T23:00:00.

conferenceCallInfo
required
string

Audio options for the attended meeting

organizerkey
required
integer <int64>

The key of the meeting organizer. Field retained for backwards compatibility reasons

startTime
required
string (AttendeesMeetingStartTime) ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$

The time the meeting instance started, e.g. 2021-07-01T23:00:00.

meetingInstanceKey
required
integer <int64>

The key of the attended meeting instance

duration
integer <int32>

The duration of attendance in minutes

newMeetingId
required
string

The formatted meeting ID

email
required
string

The email address of the meeting organizer

joinTime
string (JoinTime) ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$

The time the attendee joined the meeting instance, e.g. 2021-07-01T23:00:00.

name
required
string

The full name of the meeting organizer

leaveTime
string (LeaveTime) ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$

The time the attendee left the meeting instance, e.g. 2021-07-01T23:00:00.

attendeeEmail
required
string

The attendee's email address

meetingId
required
integer <int64>

The meeting ID

meetingType
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

firstName
required
string

The first name of the meeting organizer

newStartTime
Array of strings
Deprecated
newEndTime
Array of strings
Deprecated

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/organizers/%7BorganizerKey%7D/attendees',
  params: {startDate: 'SOME_STRING_VALUE', endDate: 'SOME_STRING_VALUE'},
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Get historical meetings by organizer

Get historical meetings for the specified organizer that started within the specified date/time range. Remark: Meetings which are still ongoing at the time of the request are NOT contained in the result array.

If you want to execute this for other organizers your client requires the Admin Center scope (identity:).
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
organizerKey
required
integer <int64>

The key of the organizer

query Parameters
startDate
required
string <date-time>

Required start of date range, in ISO8601 UTC format, e.g. 2021-07-01T22:00:00Z

endDate
required
string <date-time>

Required end of date range, in ISO8601 UTC format, e.g. 2021-07-01T23:00:00Z

Responses

Response Schema: application/json
Array
startTime
required
string (MeetingStartTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance starts or started, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

lastName
required
string

The surname of the meeting organizer

duration
required
string

The duration of the meeting session in minutes

numAttendees
required
string

The number of attendees at the meeting instance

accountKey
required
string

The key of the company account

email
required
string

The meeting organizer's email address

sessionId
required
string

The ID of the meeting session

subject
required
string

The subject of the meeting

locale
required
string

The current language setting of the organizer in the web portal

organizerKey
required
string

The key of the meeting organizer

meetingId
required
string

The meeting ID

meetingType
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

firstName
required
string

The meeting organizer's first name

endTime
required
string (MeetingEndTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance ends or ended, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

conferenceCallInfo
required
string

Audio options for the meeting

object (MeetingRecording)

Information about the meeting recording.

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/organizers/%7BorganizerKey%7D/historicalMeetings',
  params: {startDate: 'SOME_STRING_VALUE', endDate: 'SOME_STRING_VALUE'},
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Get upcoming meetings by organizer

Get upcoming meetings for a specified organizer. This API call is only available to users with the admin role.

If you want to execute this for other organizers your client requires the Admin Center scope (identity:).
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
organizerKey
required
integer <int64>

The key of the organizer

Responses

Response Schema: application/json
Array
startTime
required
string (MeetingStartTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance starts or started, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

endTime
required
string (MeetingEndTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance ends or ended, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

lastName
required
string

The surname of the meeting organizer

accountKey
required
string

The key of the company account

passwordRequired
required
string (PasswordRequiredString) ^(true|false)$

Indicates whether a password is required to join the meeting or not

email
required
string

The meeting organizer's email address

status
required
string (MeetingStatus)
Enum: "ACTIVE" "INACTIVE"

The meeting status, i.e whether the meeting is running or not

subject
required
string

The subject of the meeting

locale
required
string

The current language setting of the organizer in the web portal

organizerKey
required
string

The key of the meeting organizer

meetingId
required
string

The meeting ID

meetingType
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

firstName
required
string

The meeting organizer's first name

conferenceCallInfo
required
string

Audio options for the meeting

joinURL
required
string

The URL the meeting participants will use to join the meeting

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/organizers/%7BorganizerKey%7D/upcomingMeetings',
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Get meetings by organizer Deprecated

DEPRECATED: Please use the new API calls 'Get historical meetings by organizer' and 'Get upcoming meetings by organizer'. Gets future (scheduled) or past (history) meetings for a specified organizer. Include 'history=true' and the past start and end dates in the URL to retrieve past meetings. Enter 'scheduled=true' (without dates) to get scheduled meetings.

If you want to execute this for other organizers your client requires the Admin Center scope (identity:).
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
organizerKey
required
integer <int64>

The key of the organizer

query Parameters
scheduled
boolean

When 'true', returns all future meetings. Mutually exclusive to 'history'.

history
boolean

When 'true', returns all past meetings within date range. Mutually exclusive to 'scheduled'.

startDate
string <date-time>

If history is 'true', required start of date range, in ISO8601 UTC format, e.g. 2021-07-01T22:00:00Z

endDate
string <date-time>

If history is 'true', required end of date range, in ISO8601 UTC format, e.g. 2021-07-01T23:00:00Z

Responses

Response Schema: application/json
Array
One of
startTime
required
string (MeetingStartTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance starts or started, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

endTime
required
string (MeetingEndTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance ends or ended, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

createTime
required
string <= 0 characters

DEPRECATED. Returns an empty string ''

meetingid
required
integer <int64>

The meeting ID

maxParticipants
required
integer <int32>

The maximum number of participants allowed at the meeting

passwordRequired
required
string (PasswordRequiredString) ^(true|false)$

Indicates whether a password is required to join the meeting or not

status
required
string (MeetingStatus)
Enum: "ACTIVE" "INACTIVE"

The meeting status, i.e whether the meeting is running or not

subject
required
string

The subject of the meeting

meetingType
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

uniqueMeetingId
required
integer <int64>

A unique ID for the meeting

conferenceCallInfo
required
string

Audio options for the meeting

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/organizers/%7BorganizerKey%7D/meetings',
  params: {
    scheduled: 'SOME_BOOLEAN_VALUE',
    history: 'SOME_BOOLEAN_VALUE',
    startDate: 'SOME_STRING_VALUE',
    endDate: 'SOME_STRING_VALUE'
  },
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Delete meeting session by session id

Use this call to clean up your data by deleting any specific session. The sessionID(s) are included by meeting in the Get Historical Meetings call. Each meeting held is at least one session. One meeting may be multiple sessions if the organizer stopped and restarted the meeting for any reason, such as their device of choice did not work. Recurring meetings are at least one session per event. The call removes the specified session(s) from GoTo's servers including the sessionID, the attendee list, and any recordings. The meeting will still appear in your organizer's Meeting History, but will have no associated sessions. NOTE: The delete occurs at the session level because this provides the greatest granular control. To delete for a specific meetingID, you would need to accumualate all sessions for the meeting and apply the delete.

If you want to execute this for other organizers your client requires the Admin Center scope (identity:).
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
organizerKey
required
integer <int64>

The organizer ID

sessionId
required
integer <int64>

The session ID

Responses

Request samples 

var axios = require("axios").default;

var options = {
  method: 'DELETE',
  url: 'https://api.getgo.com/G2M/rest/organizers/%7BorganizerKey%7D/sessions/%7BsessionId%7D',
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Remove attendee list of a meeting session

Use this call to clean up your data by deleting the attendee list for a specific session. The sessionID(s) and the number of attendees at each session is included by meeting in the Get Historical Meetings call. Each meeting held is at least one session. One meeting may be multiple sessions if the organizer stopped and restarted the meeting for any reason, such as their device of choice did not work. Recurring meetings are at least one session per event. The call removes the attendee list from the session from GoTo's servers. You can remove the entire session data using the Delete Session call, or delete recordings of the meeting using the Delete Session Recordings call. The meeting will still appear in your organizer's Meeting History, but will have no associated attendees. NOTE: The delete occurs at the session level because this provides the greatest granular control. To delete for a specific meetingID, you would need to accumulate all sessions for the meeting and apply the delete.

If you want to execute this for other organizers your client requires the Admin Center scope (identity:).
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
organizerKey
required
integer <int64>

The organizer ID

sessionId
required
integer <int64>

The session ID

Responses

Request samples 

var axios = require("axios").default;

var options = {
  method: 'DELETE',
  url: 'https://api.getgo.com/G2M/rest/organizers/%7BorganizerKey%7D/sessions/%7BsessionId%7D/attendees',
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Delete recordings of a meeting session

Use this call to clean up your data by deleting recordings associated with a specific session. The sessionID(s) are included by meeting in the Get Historical Meetings call. The call removes any recordings associated with the specified session from GoTo's servers. (Any session may have multiple recordings if the feature was started and stopped multiple times during the meeting.) You can remove the entire session data using the Delete Session call, or delete attendee lists for the session using the Delete Session Attendees call. The meeting will still appear in your organizer's Meeting History, but will have no associated recordings for the specified session. NOTE: The delete occurs at the session level because this provides the greatest granular control. To delete for a specific meetingID, you would need to accumualate all sessions for the meeting and apply the delete.

If you want to execute this for other organizers your client requires the Admin Center scope (identity:).
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
organizerKey
required
integer <int64>

The organizer ID

sessionId
required
integer <int64>

The session ID

Responses

Request samples 

var axios = require("axios").default;

var options = {
  method: 'DELETE',
  url: 'https://api.getgo.com/G2M/rest/organizers/%7BorganizerKey%7D/sessions/%7BsessionId%7D/recordings',
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Meetings

Operations on meetings.

Get historical meetings

Get historical meetings for the currently authenticated organizer that started within the specified date/time range. Remark: Meetings which are still ongoing at the time of the request are NOT contained in the result array.

Authorizations:
OAuth2
query Parameters
startDate
required
string <date-time>

Required start of date range, in ISO8601 UTC format, e.g. 2021-07-01T22:00:00Z

endDate
required
string <date-time>

Required end of date range, in ISO8601 UTC format, e.g. 2021-07-01T23:00:00Z

Responses

Response Schema: application/json
Array
startTime
required
string (MeetingStartTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance starts or started, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

lastName
required
string

The surname of the meeting organizer

duration
required
string

The duration of the meeting session in minutes

numAttendees
required
string

The number of attendees at the meeting instance

accountKey
required
string

The key of the company account

email
required
string

The meeting organizer's email address

sessionId
required
string

The ID of the meeting session

subject
required
string

The subject of the meeting

locale
required
string

The current language setting of the organizer in the web portal

organizerKey
required
string

The key of the meeting organizer

meetingId
required
string

The meeting ID

meetingType
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

firstName
required
string

The meeting organizer's first name

endTime
required
string (MeetingEndTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance ends or ended, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

conferenceCallInfo
required
string

Audio options for the meeting

object (MeetingRecording)

Information about the meeting recording.

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/historicalMeetings',
  params: {startDate: 'SOME_STRING_VALUE', endDate: 'SOME_STRING_VALUE'},
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Get historical meetings by meeting id

Get historical meetings for a given meeting id.
Please note that Admins with a GoToMeeting license can only query their own meetings.
Remark: Meetings which are still ongoing at the time of the request are NOT contained in the result array.

Authorizations:
OAuth2
path Parameters
meetingId
required
integer <int64>

The meeting ID

query Parameters
startDate
string <date-time>

Optional start of date range, in ISO8601 UTC format, e.g. 2021-07-01T22:00:00Z. Default is 30 days before the current date.

endDate
string <date-time>

Optional end of date range, in ISO8601 UTC format, e.g. 2021-07-01T23:00:00Z. Default is the current date.

firstResult
integer <int32>

The index of the first result to retrieve. Default is 0.

maxResults
integer <int32>

The maximum number of results to retrieve. If not set all results will be returned (starting with the index given by firstResult).

Responses

Response Schema: application/json
Array
startTime
required
string (MeetingStartTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance starts or started, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

lastName
required
string

The surname of the meeting organizer

duration
required
string

The duration of the meeting session in minutes

numAttendees
required
string

The number of attendees at the meeting instance

accountKey
required
string

The key of the company account

email
required
string

The meeting organizer's email address

sessionId
required
string

The ID of the meeting session

subject
required
string

The subject of the meeting

locale
required
string

The current language setting of the organizer in the web portal

organizerKey
required
string

The key of the meeting organizer

meetingId
required
string

The meeting ID

meetingType
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

firstName
required
string

The meeting organizer's first name

endTime
required
string (MeetingEndTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance ends or ended, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

conferenceCallInfo
required
string

Audio options for the meeting

object (MeetingRecording)

Information about the meeting recording.

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/meetings/%7BmeetingId%7D/historicalMeetings',
  params: {
    startDate: 'SOME_STRING_VALUE',
    endDate: 'SOME_STRING_VALUE',
    firstResult: 'SOME_INTEGER_VALUE',
    maxResults: 'SOME_INTEGER_VALUE'
  },
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Get upcoming meetings

Gets upcoming meetings for the current authenticated organizer.

Authorizations:
OAuth2

Responses

Response Schema: application/json
Array
startTime
required
string (MeetingStartTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance starts or started, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

endTime
required
string (MeetingEndTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance ends or ended, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

lastName
required
string

The surname of the meeting organizer

accountKey
required
string

The key of the company account

passwordRequired
required
string (PasswordRequiredString) ^(true|false)$

Indicates whether a password is required to join the meeting or not

email
required
string

The meeting organizer's email address

status
required
string (MeetingStatus)
Enum: "ACTIVE" "INACTIVE"

The meeting status, i.e whether the meeting is running or not

subject
required
string

The subject of the meeting

locale
required
string

The current language setting of the organizer in the web portal

organizerKey
required
string

The key of the meeting organizer

meetingId
required
string

The meeting ID

meetingType
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

firstName
required
string

The meeting organizer's first name

conferenceCallInfo
required
string

Audio options for the meeting

joinURL
required
string

The URL the meeting participants will use to join the meeting

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/upcomingMeetings',
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Get meetings Deprecated

DEPRECATED: Please use the new API calls 'Get historical meetings' and 'Get upcoming meetings'. Gets historical meetings for the current authenticated organizer. Requires date range for filtering results to only meetings within specified dates. History searches will contain the parameter 'meetingInstanceKey' which is used in conjunction with the call 'Get Attendees by Meeting' to get attendee information for a past meeting. Enter 'scheduled=true' (without dates) to get scheduled meetings.

Authorizations:
OAuth2
query Parameters
scheduled
boolean

When 'true', returns all future meetings. Mutually exclusive to 'history'.

history
boolean

When 'true', returns all past meetings within date range. Mutually exclusive to 'scheduled'.

startDate
string <date-time>

If history=true, required start of date range, in ISO8601 UTC format, e.g. 2021-07-01T22:00:00Z

endDate
string <date-time>

If history=true, required end of date range, in ISO8601 UTC format, e.g. 2021-07-01T23:00:00Z

Responses

Response Schema: application/json
Array
One of
startTime
required
string (MeetingStartTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance starts or started, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

endTime
required
string (MeetingEndTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance ends or ended, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

createTime
required
string <= 0 characters

DEPRECATED. Returns an empty string ''

meetingid
required
integer <int64>

The meeting ID

maxParticipants
required
integer <int32>

The maximum number of participants allowed at the meeting

passwordRequired
required
string (PasswordRequiredString) ^(true|false)$

Indicates whether a password is required to join the meeting or not

status
required
string (MeetingStatus)
Enum: "ACTIVE" "INACTIVE"

The meeting status, i.e whether the meeting is running or not

subject
required
string

The subject of the meeting

meetingType
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

uniqueMeetingId
required
integer <int64>

A unique ID for the meeting

conferenceCallInfo
required
string

Audio options for the meeting

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/meetings',
  params: {
    scheduled: 'SOME_BOOLEAN_VALUE',
    history: 'SOME_BOOLEAN_VALUE',
    startDate: 'SOME_STRING_VALUE',
    endDate: 'SOME_STRING_VALUE'
  },
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Create meeting

Create a new meeting based on the parameters specified.

Authorizations:
OAuth2
Request Body schema: application/json

The meeting details

subject
required
string

The subject of the meeting. 100 characters maximum. The characters '>' and '<' have to be replaced with the corresponding html character code (> for '>' and < for '<')

starttime
required
string <date-time>

The starting time of the meeting. This must be a future date and time, represented as an ISO8601 UTC string, e.g. 2029-07-01T22:00:00Z

endtime
required
string <date-time>

The ending time of the meeting. This must be a future date and time, represented as an ISO8601 UTC string, e.g. 2029-07-01T23:00:00Z

passwordrequired
required
boolean

Indicates whether a password is required to join the meeting. Required parameter

conferencecallinfo
required
string

A required string. Can be one of the following options: PSTN (PSTN only), Free (PSTN and VoIP), Hybrid, (PSTN and VoIP), Private (you provide numbers and access code), or VoIP (VoIP only). You may also enter plain text for numbers and access codes with a limit of 255 characters

timezonekey
string

DEPRECATED. Must be provided and set to empty string ''

meetingtype
required
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

coorganizerKeys
Array of strings

Co-organizer keys. Co-organizers can start the meeting on the organizers behalf. Retrieve a list of valid organizers from the 'Get Users' call.

Responses

Response Schema: application/json
Array
joinURL
required
string

The URL the meeting participants will use to join the meeting

meetingid
required
integer <int64>

The meeting ID

maxParticipants
required
integer <int32>

The maximum number of participants allowed in the meeting

uniqueMeetingId
required
integer <int64>

The meeting ID. Field retained for backwards compatibility reasons

conferenceCallInfo
required
string

Audio options for the meeting

Request samples

Content type
application/json
{
  • "subject": "string",
  • "starttime": "2019-08-24T14:15:22Z",
  • "endtime": "2019-08-24T14:15:22Z",
  • "passwordrequired": true,
  • "conferencecallinfo": "string",
  • "timezonekey": "string",
  • "meetingtype": "immediate",
  • "coorganizerKeys": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Get meeting

Returns the meeting details for the specified meeting.

Authorizations:
OAuth2
path Parameters
meetingId
required
integer <int64>

The meeting ID

Responses

Response Schema: application/json
Array
One of
createTime
required
string <= 0 characters

DEPRECATED. Returns an empty string ''

passwordRequired
required
string (PasswordRequiredString) ^(true|false)$

Indicates whether a password is required to join the meeting or not

status
required
string (MeetingStatus)
Enum: "ACTIVE" "INACTIVE"

The meeting status, i.e whether the meeting is running or not

subject
required
string

The subject of the meeting

conferenceCallInfo
required
string

Audio options of the meeting

maxParticipants
required
integer <int32>

The maximum number of participants allowed at the meeting

meetingId
required
integer <int64>

The meeting ID

meetingKey
required
integer <int64>

The meeting ID. Field retained for backwards compatibility reasons

meetingType
required
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

uniqueMeetingId
required
integer <int64>

The meeting ID. Field retained for backwards compatibility reasons

coorganizerKeys
Array of strings

The co-organizer keys of users that also can host the meeting.

joinURL
required
string

The URL the meeting participants will use to join the meeting

startTime
required
string (MeetingStartTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance starts or started, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

endTime
required
string (MeetingEndTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.[+-]\d...

The time the meeting instance ends or ended, e.g. 2021-07-01T23:00:00.+0000. Can be empty if the time is not specified.

duration
required
integer <int32>

The duration of the meeting in minutes

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/meetings/%7BmeetingId%7D',
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Delete meeting

Deletes the meeting identified by the meetingId.

Authorizations:
OAuth2
path Parameters
meetingId
required
integer <int64>

The meeting ID

Responses

Request samples 

var axios = require("axios").default;

var options = {
  method: 'DELETE',
  url: 'https://api.getgo.com/G2M/rest/meetings/%7BmeetingId%7D',
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Update meeting

Updates an existing meeting specified by meetingId.

Authorizations:
OAuth2
path Parameters
meetingId
required
integer <int64>

The meeting ID

Request Body schema: application/json

The meeting details

subject
required
string

A description of the meeting. 100 characters maximum. The characters '>' and '<' have to be replaced with the corresponding html character code (> for '>' and < for '<')

starttime
required
string <date-time>

The starting time of the meeting. This must be a future date and time, represented as an ISO8601 UTC string, e.g. 2029-07-01T22:00:00Z

endtime
required
string <date-time>

The ending time of the meeting. This must be a future date and time, represented as an ISO8601 UTC string, e.g. 2029-07-01T23:00:00Z

passwordrequired
required
boolean

Indicates whether a password is required to join the meeting. Required parameter

conferencecallinfo
required
string

A required string. Can be one of the following options: PSTN (PSTN only), Free (PSTN and VoIP), Hybrid, (PSTN and VoIP), Private (you provide numbers and access code), or VoIP (VoIP only). You may also enter plain text for numbers and access codes with a limit of 255 characters

timezonekey
string

DEPRECATED. Must be provided and set to empty string ''

meetingtype
required
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

coorganizerKeys
Array of strings

Co-organizer keys. Co-organizers can start the meeting on the organizers behalf. Retrieve a list of valid organizers from the 'Get Users' call.

Responses

Request samples

Content type
application/json
{
  • "subject": "string",
  • "starttime": "2019-08-24T14:15:22Z",
  • "endtime": "2019-08-24T14:15:22Z",
  • "passwordrequired": true,
  • "conferencecallinfo": "string",
  • "timezonekey": "string",
  • "meetingtype": "immediate",
  • "coorganizerKeys": [
    ]
}

Start meeting

Returns a host URL that can be used to start a meeting. When this URL is opened in a web browser, the GoTo Meeting client will be downloaded and launched and the meeting will start. The end user is not required to login to a client.

Authorizations:
OAuth2
path Parameters
meetingId
required
integer <int64>

The meeting ID

Responses

Response Schema: application/json
hostURL
required
string

The host URL that can be used to start a meeting.

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/meetings/%7BmeetingId%7D/start',
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
{
  • "hostURL": "string"
}

Get attendees by meeting

List all attendees for specified meetingId of historical meeting. The historical meetings can be fetched using 'Get historical meetings', 'Get historical meetings by organizer', and 'Get historical meetings by group'. For users with the admin role this call returns attendees for any meeting. For any other user the call will return attendees for meetings on which the user is a valid organizer.

Please note that your client requires the Admin Center scope (identity:) to execute this API request.
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
meetingId
required
integer <int64>

The meeting ID

Responses

Response Schema: application/json
Array
lastName
required
string

The surname of the meeting organizer

groupName
required
string

DEPRECATED. Returns 'NA'

numAttendees
required
integer <int32>

The number of attendees at the meeting instance

attendeeName
required
string

The attendee's full name

subject
required
string

The subject of the meeting

endTime
string (AttendeesMeetingEndTime) ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$

The time the meeting instance ended, e.g. 2021-07-01T23:00:00.

conferenceCallInfo
required
string

Audio options for the meeting

organizerkey
required
integer <int64>

The key of the meeting organizer

startTime
required
string (AttendeesMeetingStartTime) ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$

The time the meeting instance started, e.g. 2021-07-01T23:00:00.

meetingInstanceKey
required
integer <int64>

The key of the unique meeting instance

duration
integer <int32>

The meeting duration in minutes

email
required
string

The email address of the meeting organizer

joinTime
string (JoinTime) ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$

The time the attendee joined the meeting instance, e.g. 2021-07-01T23:00:00.

name
required
string

The attendee's full name

leaveTime
string (LeaveTime) ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$

The time the attendee left the meeting instance, e.g. 2021-07-01T23:00:00.

attendeeEmail
required
string

The attendee's email address

meetingId
required
integer <int64>

The meeting ID

meetingType
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

firstName
required
string

The first name of the meeting organizer

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/meetings/%7BmeetingId%7D/attendees',
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Groups

Operations on groups. Only available to users with the admin role.

Get groups Deprecated


DEPRECATED: To 'Get groups', please use 'Get groups' from the GoTo Admin API.

List all groups for an account. This API call is only available to users with the admin role.

Please note that your client requires the Admin Center scope (identity:) to execute this API request.
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2

Responses

Response Schema: application/json
Array
groupkey
required
integer <int64>

The key of this group

groupName
required
string

The name of this group

parentKey
required
integer <int64>

The key of the parent group this group belongs to. Identical with the groupkey if this group is not a subgroup

status
required
string (Status)
Enum: "active" "suspended" "inactive"

The status of an organizer (or group), i.e. whether the organizer (or the members of the group respectively) are able to host meetings

numOrganizers
required
integer <int32>

The number of organizers assigned to this group

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/groups',
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Get attendees by group

Returns all attendees for all meetings within specified date range held by organizers within the specified group. This API call is only available to users with the admin role. This API call can be used only for groups with maximum 50 organizers.

Please note that your client requires the Admin Center scope (identity:) to execute this API request.
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
groupKey
required
integer <int64>

The key of the group

query Parameters
startDate
required
string <date-time>

Start of date range, in ISO8601 UTC format, e.g. 2021-07-01T22:00:00Z

endDate
required
string <date-time>

End of date range, in ISO8601 UTC format, e.g. 2021-07-01T23:00:00Z

Responses

Response Schema: application/json
Array
lastName
required
string

The surname of the meeting organizer

groupName
required
string

The name of the group

numAttendees
required
integer <int32>

The number of attendees at the attended meeting instance

attendeeName
required
string

The full name of the attendee

subject
required
string

The subject of the attended meeting

endTime
string (GroupMeetingStartTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z...

The time the meeting instance starts or started, e.g. 2021-07-01T23:00:00.000Z. Can be empty if the time is not specified.

conferenceCallInfo
required
string

Audio options for the attended meeting

organizerkey
required
integer <int64>

The key of the meeting organizer. Field retained for backwards compatibility reasons

startTime
required
string (GroupMeetingEndTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z...

The time the meeting instance ends or ended, e.g. 2021-07-01T23:00:00.000Z. Can be empty if the time is not specified.

meetingInstanceKey
required
integer <int64>

The key of the attended meeting instance

duration
integer <int32>

The duration of attendance in minutes

joinTime
string (GroupJoinTime) ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$...

The time the attendee joined the meeting instance, e.g. 2021-07-01T23:00:00.000Z.

email
required
string

The email address of the meeting organizer

leaveTime
string (GroupLeaveTime) ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$...

The time the attendee left the meeting instance, e.g. 2021-07-01T23:00:00.000Z.

attendeeEmail
required
string

The attendee's email address

organizerKey
required
string

The key of the meeting organizer

meetingId
required
string

The meeting ID

meetingType
required
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

firstName
required
string

The first name of the organizer of the attended meeting

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/groups/%7BgroupKey%7D/attendees',
  params: {startDate: 'SOME_STRING_VALUE', endDate: 'SOME_STRING_VALUE'},
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Get historical meetings by group

Get historical meetings for the specified group that started within the specified date/time range. This API call is only available to users with the admin role. This API call is restricted to groups with a maximum of 50 organizers. Remark: Meetings which are still ongoing at the time of the request are NOT contained in the result array.

Please note that your client requires the Admin Center scope (identity:) to execute this API request.
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
groupKey
required
integer <int64>

The key of the group

query Parameters
startDate
required
string <date-time>

Required start of date range, in ISO8601 UTC format, e.g. 2021-07-01T22:00:00Z

endDate
required
string <date-time>

Required end of date range, in ISO8601 UTC format, e.g. 2021-07-01T23:00:00Z

Responses

Response Schema: application/json
Array
startTime
required
string (GroupMeetingStartTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z...

The time the meeting instance starts or started, e.g. 2021-07-01T23:00:00.000Z. Can be empty if the time is not specified.

endTime
string (GroupMeetingEndTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z...

The time the meeting instance ends or ended, e.g. 2021-07-01T23:00:00.000Z. Can be empty if the time is not specified.

lastName
required
string

The surname of the meeting organizer

duration
required
string

The duration of the meeting session in minutes

numAttendees
required
string

The number of attendees at the meeting instance

accountKey
required
string

The key of the company account

email
required
string

The meeting organizer's email address

subject
required
string

The subject of the meeting

locale
required
string

The current language setting of the organizer in the web portal

organizerKey
required
string

The key of the meeting organizer

meetingId
required
string

The meeting ID

meetingType
required
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

firstName
required
string

The meeting organizer's first name

groupName
required
string

The name of the group

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/groups/%7BgroupKey%7D/historicalMeetings',
  params: {startDate: 'SOME_STRING_VALUE', endDate: 'SOME_STRING_VALUE'},
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Get upcoming meetings by group

Get upcoming meetings for a specified group. This API call is only available to users with the admin role. This API call can be used only for groups with maximum 50 organizers.

Please note that your client requires the Admin Center scope (identity:) to execute this API request.
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
groupKey
required
integer <int64>

The key of the group

Responses

Response Schema: application/json
Array
startTime
required
string (GroupMeetingStartTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z...

The time the meeting instance starts or started, e.g. 2021-07-01T23:00:00.000Z. Can be empty if the time is not specified.

endTime
required
string (GroupMeetingEndTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z...

The time the meeting instance ends or ended, e.g. 2021-07-01T23:00:00.000Z. Can be empty if the time is not specified.

lastName
required
string

The surname of the meeting organizer

accountKey
required
string

The key of the company account

passwordRequired
required
string (PasswordRequiredString) ^(true|false)$

Indicates whether a password is required to join the meeting or not

email
required
string

The meeting organizer's email address

status
string (MeetingStatus)
Enum: "ACTIVE" "INACTIVE"

The meeting status, i.e whether the meeting is running or not

subject
required
string

The subject of the meeting

locale
required
string

The current language setting of the organizer in the web portal

organizerKey
required
string

The key of the meeting organizer

meetingId
required
string

The meeting ID

meetingType
required
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

firstName
required
string

The meeting organizer's first name

groupName
required
string

The name of the group the meeting belongs to

joinURL
required
string

The URL the meeting participants will use to join the meeting

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/groups/%7BgroupKey%7D/upcomingMeetings',
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Get meetings by group Deprecated

DEPRECATED: Please use the new API calls 'Get historical meetings by group' and 'Get upcoming meetings by group'. Get meetings for a specified group. Additional filters can be used to view only meetings within a specified date range. This API call is only available to users with the admin role.

Please note that your client requires the Admin Center scope (identity:) to execute this API request.
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
groupKey
required
integer <int64>

The key of the group

query Parameters
scheduled
boolean

When 'true', returns all future meetings within date range. Mutually exclusive to 'history'.

history
boolean

When 'true', returns all past meetings within date range. Mutually exclusive to 'scheduled'.

startDate
required
string <date-time>

Start of date range, in ISO8601 UTC format, e.g. 2021-07-01T22:00:00Z

endDate
required
string <date-time>

End of date range, in ISO8601 UTC format, e.g. 2021-07-01T23:00:00Z

Responses

Response Schema: application/json
Array
One of
lastName
required
string

The surname of the meeting organizer

groupName
required
string

The name of the group

numAttendees
required
integer <int32>

The number of attendees at this meeting instance

subject
required
string

The subject of the meeting

endTime
string (GroupMeetingEndTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z...

The time the meeting instance ends or ended, e.g. 2021-07-01T23:00:00.000Z. Can be empty if the time is not specified.

conferenceCallInfo
required
string

Audio options for the meeting

organizerkey
required
integer <int64>

The key of the meeting organizer. Field retained for backwards compatibility reasons

startTime
required
string (GroupMeetingStartTime) ^(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z...

The time the meeting instance starts or started, e.g. 2021-07-01T23:00:00.000Z. Can be empty if the time is not specified.

meetingInstanceKey
required
integer <int64>

The key of this meeting instance

duration
required
integer <int64>

The duration of this meeting instance in minutes

email
required
string

The email address of the meeting organizer

organizerKey
required
string

The key of the meeting organizer

meetingId
required
string

The meeting ID

meetingType
required
string (MeetingType)
Enum: "immediate" "recurring" "scheduled"

The meeting type

firstName
required
string

The first name of the meeting organizer

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/groups/%7BgroupKey%7D/meetings',
  params: {
    scheduled: 'SOME_BOOLEAN_VALUE',
    history: 'SOME_BOOLEAN_VALUE',
    startDate: 'SOME_STRING_VALUE',
    endDate: 'SOME_STRING_VALUE'
  },
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Create organizer in group Deprecated


DEPRECATED: To 'Create organizer in group', please use 'Add users' from the GoTo Admin API.

Creates a new organizer and sends an email to the email address defined in the request. This API call is only available to users with the admin role. You may also pass 'G2W', 'G2T', 'OPENVOICE', 'G2ASEEIT', 'G2ARS' or 'G2ASD' as productType variables, creating organizers for those products. A G2W or G2T organizer will also have access to G2M.

Please note that your client requires the Admin Center scope (identity:) to execute this API request.
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
groupKey
required
integer <int64>

The key of the group

Request Body schema: application/json

The details of the organizer to be created

organizerEmail
required
string

The email address of the organizer

firstName
string

The first name of the organizer

lastName
string

The surname of the organizer

productType
string (Product)
Enum: "G2M" "G2W" "G2T" "OPENVOICE" "G2ASEEIT" "G2ARS" "G2ASD"

Responses

Response Schema: application/json
Array
key
required
string^\d+$

The organizer's key

email
required
string

The organizer's email address

Request samples

Content type
application/json
{
  • "organizerEmail": "string",
  • "firstName": "string",
  • "lastName": "string",
  • "productType": "G2M"
}

Response samples

Content type
application/json
[
  • {
    }
]

Get organizers by group Deprecated


DEPRECATED: To 'Get organizers by group', please use 'Get users' from the GoTo Admin API.

Returns all the organizers within a specific group. This API call is only available to users with the admin role.

Please note that your client requires the Admin Center scope (identity:) to execute this API request.
How to create a client is described in a HowTo, but you can also add the missing scope to an existing OAuth client.

Authorizations:
OAuth2
path Parameters
groupKey
required
integer <int64>

The key of the group

Responses

Response Schema: application/json
Array
lastName
required
string

The organizer's surname

groupId
required
integer <int64>

The key of the group

groupName
required
string

The name of the group

status
required
string (Status)
Enum: "active" "suspended" "inactive"

The status of an organizer (or group), i.e. whether the organizer (or the members of the group respectively) are able to host meetings

email
required
string

The organizer's email address

organizerKey
required
integer <int64>

The key of the organizer

firstName
required
string

The organizer's first name

products
required
Array of strings (Product)
Items Enum: "G2M" "G2W" "G2T" "OPENVOICE" "G2ASEEIT" "G2ARS" "G2ASD"
maxNumAttendeesAllowed
required
integer <int32>

The maximum number of attendees allowed at sessions held by this organizer

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.getgo.com/G2M/rest/groups/%7BgroupKey%7D/organizers',
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]

Meeting Rooms

Get Profile meeting with user key

Get the profile meeting for a given organizer. Requires the user key of the organizer.

Authorizations:
OAuth2
query Parameters
userKey
required
string

The user key of a given organizer

Responses

Response Schema: application/json
Array
userKey
required
string

The user key of the profile owner

meetingId
required
string

The meeting id associated with the profile

profileId
required
string

The profile id of the organizer (url part of the personal meeting room)

theme
required
string

The theme of the profile used in the MeetMe page

showMeetMePage
required
boolean

Indicates whether the profile url leads to a meetMe page or direct join

Request samples 

var axios = require("axios").default;

var options = {
  method: 'GET',
  url: 'https://api.goto.com/meeting-room/v1/profiles',
  params: {userKey: 'SOME_STRING_VALUE'},
  headers: {Authorization: 'Bearer REPLACE_BEARER_TOKEN'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Response samples

Content type
application/json
[
  • {
    }
]