Better Stack's Zoom integration lets you create Zoom meetings for incidents. Meetings can be created automatically when an incident is triggered, through an escalation policy, or manually on demand. A link to the meeting is posted to the incident timeline so everyone can join.

Adding the app

Prerequisites

• The Monitors & Heartbeats → Integrations permission within your Better Stack team.

Steps

1. Go to Integrations.
2. Scroll to the Meetings tab and click Add next to Zoom.
3. You will be redirected to Zoom's authorization screen. Sign in to the Zoom account you want to connect, then click Allow to grant the requested permissions.
4. You will be redirected back to Better Stack, where you can configure the integration:
   • Name: give the integration a descriptive name, such as "Operations Team Zoom".
   • Create a meeting every time an incident occurs: enable this to have a Zoom meeting created the moment an incident is triggered.
5. Click Save changes to finish.

You can connect multiple Zoom accounts to the same Better Stack team. In the Meetings tab, click Add another and repeat the steps above.

Admin approval may be required

Depending on your Zoom account's configuration, admin approval may be needed to install the app. If you encounter an error during authorization, see the Troubleshooting section below.

Permissions requested

During authorization, Better Stack requests the following Zoom scopes:

• meeting:write:meeting: allows Better Stack to create Zoom meetings on your behalf when an incident is triggered.
• user:read:user: allows Better Stack to read basic user information to identify the connected account within the integration settings. Your Zoom name is stored as the integration label and your account identifiers are stored to maintain the connection. Both are deleted when the integration is removed.

Usage

Automatic meetings for all incidents

Use case: Every incident should immediately have a Zoom meeting so your on-call engineers can jump in without coordinating a link manually.

Prerequisites: The Zoom integration must be connected and Create a meeting every time an incident occurs must be enabled in the integration settings.

How it works:

1. An incident is created in Better Stack.
2. Better Stack creates a Zoom meeting on behalf of the connected Zoom user.
3. The meeting join URL appears in the incident timeline.
4. Incident responders can click the link to join immediately. No host is required.

Meeting creation via escalation policies

Use case: You want a Zoom meeting created only for specific incidents, such as high-severity ones, or after a delay if the incident isn't acknowledged quickly.

Prerequisites:

• The Zoom integration must be connected.
• Create a meeting every time an incident occurs should be disabled in the integration settings.
• An escalation policy must be configured with a Zoom meeting step.

How it works:

1. Go to On-call → Escalation policies.
2. Add a new step and select your Zoom integration, or select All Zoom integrations.
3. Optionally add a delay. For example, create the meeting only if the incident isn't acknowledged within 5 minutes.
4. Click Save changes.

When this escalation step fires, Better Stack creates a Zoom meeting and logs the join URL in the incident timeline.

Manual meeting creation

Use case: An incident is already in progress and you want to start a Zoom meeting for it on demand.

Prerequisites: The Zoom integration must be connected.

How it works:

1. Open the incident in Better Stack.
2. On the incident page, click Create Zoom in the header.
3. The meeting join URL appears immediately in the incident timeline.

Removing the app

From Better Stack

1. Go to Integrations.
2. In the Meetings tab, find the Zoom integration you want to remove.
3. Click the integration name to open its settings, then click Remove and confirm.

Better Stack will immediately revoke your OAuth authorization with Zoom and delete all stored credentials from our systems.

From the Zoom App Marketplace

1. Log in to your Zoom account and navigate to the Zoom App Marketplace.
2. Go to Manage → Added Apps, or search for Better Stack.
3. Select the Better Stack app.
4. Click Remove.

Implications of removal

• Escalation policies: Any escalation policy steps that reference the removed Zoom integration will no longer create meetings. Update your policies to remove or replace the affected steps.
• Existing incidents: Incidents that already have a Zoom meeting link are not affected. The meeting URLs recorded in the timeline remain visible.
• Multiple accounts: If you connected multiple Zoom accounts, removing one integration does not affect the others.

Data handling after removal

When you remove the integration from Better Stack, we:

• Immediately revoke the OAuth access token with Zoom's API.
• Permanently delete the stored access token, refresh token, and Zoom account identifiers from our database.
• Do not retain any personal data. Meeting URLs previously recorded in incident timelines remain as part of the incident history but contain no personal information. They hold only the meeting join URL generated by Zoom.

Troubleshooting

"Zoom couldn't be connected" during authorization

• Make sure you are signed in to the correct Zoom account before authorizing.
• Try the authorization flow again in an incognito or private browser window to rule out cookie conflicts.
• Check that your Zoom account has permission to install Marketplace apps. Some Zoom administrators restrict app installations, so contact your Zoom admin if needed.

Zoom meetings are not being created for incidents

1. Check that your Zoom integration is connected in Integrations → Meetings.
2. If Create a meeting every time an incident occurs is disabled, verify that your escalation policy includes a Zoom meeting step and that the policy is assigned to the affected monitor.
3. If the issue persists, try removing and re-adding the integration.

"Create Zoom" is missing from the incident page

• Ensure the Better Stack app is installed and authorized in your Zoom account. Navigate to Manage → Added Apps in the Zoom Marketplace to verify.
• Try disconnecting and reconnecting the integration from the Integrations page in Better Stack.

FAQ

Do I need a paid Zoom account to use the integration? No, the Better Stack Zoom integration works with any Zoom account, including the free Basic plan.

Who can create Zoom meetings from an incident? Any Better Stack team member with access to an incident can create a Zoom meeting, provided the Zoom integration has been set up for the team.

Can I connect multiple Zoom accounts? Yes. In the Meetings tab on the Integrations page, click Add another to connect additional Zoom accounts. Each operates independently.

Contact support

If you cannot resolve an issue using the steps above, contact the Better Stack support team through our Help Center.