Use the meeting room generator to create collaborative communication environments. We recommend creating a meeting room for a combination of people. Vectera really shines in creating meeting rooms for synchronous collaboration.

Example: Generate a meeting room for each adviser-client and allow both to access the meeting room with a shared link.

Generate meeting room

First, authenticate using the token. You must use a request header for the authentication.

You can generate a meeting room by doing a POST request to the following endpoint

https://www.vectera.com/api/v1/meetings/

You can specify parameters using the JSON format, these parameters must be added in the body (not in the head!).

Most important ones:

  • "key": Set the meeting room name and the associated link

  • "publicAccessLevel": Change the meeting room status to open "can_always_join" (anyone with the link can access) or closed "should_knock" (only hosts can allow guests to access). The default is locked.

If you want to generate a meeting room for another team member, you will have to follow these steps:

1. Copy the id of the team member for whom you want to generate a meeting room, by doing a GET request to https://www.vectera.com/api/v1/users/. Use a filter or sort the results to ease your search if you have a lot of team members.

In the preview, you will see the team members. Copy the Id of the correct team member.

2. Do a POST request to https://www.vectera.com/api/v1/meetings with the parameters "key" and "owner_id"

  • "key": Set the meeting room name and the associated link

  • "owner_id": Id of the team member for whom you want to generate a meeting room.

In Vectera it's possible to give users specific access to meeting rooms, even with the API. Depending on your workflow you can choose to create a user and give access with a special login token or you can generate special access keys which are not linked to any account. If you prefer the last option follow the steps below.

After generating a meeting room, you can obtain the meeting room id, which is needed for generating an access key. These access keys are 30-character keys and are far less likely to be "guessed" than regular user passwords. 

Use the permissions endpoint to generate the access link:

https://www.vectera.com/api/v1/meetings/[id]/permissions/

Send a POST request with the parameters:

  • Can always join but no hosts rights: "accessLevel":"can_always_join"

  • Has host rights: "accessLevel":"is_host"

In this particular example, the full link with the access key can be given to the guest who can join the meeting room without knocking. The link without access key can be given to people who should not have continuous access to the meeting room and require a host to let them into the meeting room.


In a case where all participants should have equal access (a group of collaborators), you could share the full access link. Be advised that anyone using this access link can enter the meeting room at any time. It is important to set up a workflow to make sure this key is hidden or only shared with the relevant people. 

When you end a meeting with a lead or client, it is a good idea to forward them to a specific (thank you) page on your website. It's possible to set this up via the team settings or via the API for a meeting room.

Send a POST request to https://www.vectera.com/api/v1/meetings/ to generate a meeting room and add "settings":{"forwardUrl": "URL"} as a parameter.

In the example below, the guest will be forwarded to go.vectera.com when the meeting ends.

You can change the forward URL by sending a PATCH request to https://www.vectera.com/api/v1/meetings/meetingRoomId.

Add a new link to change the link or leave blank to remove the link.

Next: Do you want to create meeting room templates and apply them to specific meeting rooms via the API? This help article will guide you.

Other API information

Connecting and authenticating with Vectera

Guide: Integrating the booking app

Guide: manage and authenticate users

Guide: How to create/add templates for your meeting rooms via API?

Guide: Filter and sort results

API Reference


The Vectera team is looking forward to your feedback. Our main goal still is to improve your experience in creating online meeting rooms. Eager to get going? Log into your account or get started with a free, fully-featured trial of Vectera!

Did this answer your question?