Zoom

With the Zoom integration, Kinpal creates a Zoom meeting on your account at the moment you finalize a poll. The join link goes into the event, the calendar invite and the confirmation emails, so participants never wait for a link to follow.

​

How it works

1. You connect your Zoom account once, from your settings.
2. When you create a poll, you choose Zoom as the video call. The poll shows “Zoom” to participants while voting is open; there is no link yet.
3. When you finalize the poll, Kinpal creates a Zoom meeting for the chosen time on your Zoom account and attaches the join link to the event.

The meeting is created on the Zoom account you connected, so it follows that account’s settings, such as waiting rooms, passcodes and recording defaults. Kinpal does not change those settings.

​

Requirements

• A Zoom account. A free Zoom plan is enough.
• The Zoom integration must be enabled on the Kinpal instance you use. On kinpal.com it is available to all accounts; on a self-hosted instance the administrator turns it on.

​

Adding the app

You can connect one Zoom account per Kinpal account. To switch to a different Zoom account, disconnect the current one, then connect the new one.

​

Using the integration

​

Choosing Zoom for a poll

When creating a poll, click Add video call and choose Zoom. The form shows “Zoom” as the video call for this poll. If your Zoom account is not connected, the form tells you so and links to Conferencing settings. Participants see “Zoom” on the poll page while voting is open. No meeting exists yet.

​

Finalizing the poll

When you finalize the poll and pick the winning time, Kinpal:

1. Creates a scheduled Zoom meeting on your account for that date and time, using the poll title as the meeting topic.
2. Attaches the join link to the event.
3. Includes the link in the calendar invite (.ics) and in the confirmation emails sent to you and to participants.

The meeting also appears in your Zoom account under Meetings, where you can edit or delete it like any other meeting. If the meeting cannot be created, for example because the Zoom connection has expired, the poll stays open and Kinpal shows an error. Reconnect your account in Conferencing settings and finalize again.

​

Which account hosts the meeting

The meeting is created on the Zoom account of the poll’s organizer. If a space member finalizes a poll organized by someone else, the meeting is still created on the organizer’s Zoom account.

​

Permissions

When you connect, Kinpal asks Zoom for these permissions: Kinpal does not read your existing meetings, recordings, contacts or chat, and does not join or record meetings.

​

Data Kinpal stores

For a connected Zoom account, Kinpal stores:

• Your Zoom account id and email address, to identify the connection and show it in your settings.
• The access token and refresh token Zoom issues, encrypted at rest, so Kinpal can create meetings on your behalf without asking you to sign in each time.

For each finalized poll, Kinpal stores the meeting id, join link and passcode of the meeting it created, as part of the event. Kinpal does not store the content of any meeting.

​

Removing the app

​

From Kinpal

1. Open Settings, then Conferencing.
2. Next to Zoom, click the More options button and choose Disconnect.

The connection is removed immediately: Kinpal deletes the account details and tokens it stored, then asks Zoom to revoke its access. To confirm the access is gone, remove the app from Zoom as described below. Polls that already chose Zoom keep that choice but can no longer be finalized with a Zoom link until an account is connected again. Meetings Kinpal already created stay in your Zoom account; delete them from Zoom if you no longer need them.

​

From Zoom

You can also remove the app from the Zoom side:

1. Sign in to the Zoom App Marketplace.
2. Click Manage, then Added Apps.
3. Find Kinpal and click Remove.

Removing the app from Zoom revokes Kinpal’s access. Zoom tells Kinpal, which deletes the connection and the tokens it stored, so the account no longer appears in your settings. On a self-hosted instance, this needs the administrator to set up Zoom’s deauthorization notice, which Zoom only sends for apps published on the Marketplace. If the account still appears in your settings, disconnect it in Kinpal as well.

​

Troubleshooting

“Zoom is not connected” when creating a poll. Your Kinpal account has no Zoom connection, or it was removed. Connect one in Conferencing settings and choose Zoom again. Finalizing fails with a video call error. The Zoom connection has expired or was revoked on the Zoom side. Disconnect and reconnect the account, then finalize again. The poll is unchanged until finalizing succeeds. The meeting was created on the wrong account. The meeting is always created on the poll organizer’s connected Zoom account. Check which account is connected in Conferencing settings. Still stuck? Contact support.