Skip to main content

Connecting Apps to Vanta Agent

✅ Feature availability: Any customer with access to Vanta Agent and Vanta AI enabled can connect apps, on any plan. Connections are not available in FedRAMP environments.

Overview

Connect your third-party apps, such as Slack, Linear, Notion, and Atlassian, to Vanta Agent so it can look up information and take supported actions in those apps without you leaving Vanta. For example, you can ask the Agent to create Jira tickets for failing tests, message evidence owners in Slack, or compare a Notion runbook with a policy in Vanta.

The Agent uses your existing permissions in each connected app, so it can only see and do what you can.

ℹ️ Note: This article covers connecting Vanta Agent to third-party apps. To use Vanta data inside an outside AI tool such as Claude or Cursor, see Connecting to Vanta MCP.


Before you begin

Who can connect: Any Vanta role can connect apps, as long as the person has access to Vanta Agent.

Before you connect, keep in mind:

  • Each person connects their own account. A connection belongs to you. No other Vanta user, including admins, can use it.

  • You need an account in the app. The Agent can only do what your account is allowed to do there.


Connect an app

You connect each app separately. Connecting opens the app's own sign-in and approval screen.

The Connections tab explains that these connections are personal: only you can see them, and Vanta Agent acts with your own permissions in each app.

  1. In Vanta, select Vanta Agent in the left navigation, then select Settings.

  2. Select the Connections tab.

  3. Find the app you want to connect.

  4. Select Connect next to the app. While one connection is in progress, the other Connect buttons are unavailable.

  5. Vanta takes you to the app. Sign in if prompted, then review the access request and approve it.

  6. You return to Vanta. The app now shows Connected.

To confirm the connection worked, check that the status shows Connected, or ask the Agent: "Which of my apps are connected to Vanta Agent?"

To learn about an app's own setup, select Learn about connecting next to the app.


Use a connection

After you connect an app, ask the Agent in chat as you normally would. Name the app in your request, for example "in Jira" or "in Slack", so the Agent knows where to look or act.

Connections work wherever you use Vanta Agent: in the app, in Custom Agent runs, and in Vanta Agent in Slack.

Look up information

App

Example prompt

Notion

Find our incident response runbook in Notion and flag anything that doesn't match our Incident Response policy in Vanta.

Slack

Find the latest Slack update about an evidence request. Summarize what’s still outstanding.

Linear

Search Linear for an issue tracking a critical vulnerability. Share the latest status.

Atlassian

Check whether there’s already a Jira ticket for a failing test in Vanta. Summarize the latest update.

Take action

App

Example prompt

Atlassian

Create a Jira ticket for each failing test and assign it to the test owner with remediation instructions.

Slack

Find documents with expiring evidence and send each owner a Slack message with what's wrong and what they need to do next.

Linear and Slack

Create Linear issues for critical vulnerabilities and assign them to the service owner. Then send the owner the link and a short summary in Slack.

Approve actions

Before the Agent takes an action in a connected app, it shows an approval card. The card names the app, the action the Agent wants to run, and the information it will send.

  • Select Allow to let the Agent continue.

  • Select Don't allow to cancel the action.

Each action needs its own approval, so you stay in control of every change. Review the values before you approve, because long values may be shortened on the card.

Slack: When you connect Slack, Vanta Agent uses your Slack account to search for messages and post to supported channels and threads. Access depends on your Slack permissions and what your workspace authorizes. The approval card shows the draft message, and the Agent sends it only after you approve.

Requests that only read information may run without asking for approval.

When an app isn't connected

If your request needs an app that isn't connected, or a connection has expired, the Agent tells you and links to your connection settings. Select the link to open the Connections tab, connect or reconnect the app, then ask again. For some requests, such as a Slack message, the Agent may also give you a draft you can send yourself.


Manage connections

Check connection status

Open the Connections tab in Vanta Agent settings. Each app shows one of three statuses.

Status

What it means

What to do

Connected

The Agent can use the app with your account.

Nothing.

Not connected

You haven't connected the app, or you didn't finish signing in.

Select Connect.

Needs reconnect

Your access expired or was revoked, or Vanta couldn't connect to the app.

Select Reconnect, then retry your request.

You can also ask the Agent which apps are connected.

Reconnect an app

  1. Open the Connections tab in Vanta Agent settings.

  2. Select Reconnect next to the app.

  3. Sign in to the app if prompted, then approve the access request.

  4. Retry your request in the Agent.

You reconnect from the Connections tab only. The Agent can't reconnect an app for you during a conversation.

Disconnect an app

Select Disconnect next to the app. No confirmation message appears. The app returns to Not connected right away, and the Agent can no longer use it.

To use the app again, select Connect and approve access.

Review what the Agent did

Vanta's Event Log records when you connect and disconnect an app. To review a specific action the Agent took, check the connected app itself. For example, a Slack message or Jira issue history shows that the item was sent using Vanta.


Troubleshooting and FAQs

Messages when connecting

Message

What to do

Signing in didn't finish. Please try connecting again.

Select Connect to start over. A sign-in request can expire if you leave the app's page open for too long, and you can only connect one app at a time.

You signed in, but Vanta AI couldn't connect to the server. Please try again.

Wait a moment, then select Connect again. If it continues, contact Vanta Support.

Something went wrong connecting this server. Please try again.

Select Connect again. If it continues, contact Vanta Support.

Couldn't disconnect {app}. Please try again.

Select Disconnect again.

The Agent can't use an app

If an app shows Needs reconnect, select Reconnect. If the app shows Connected but the Agent doesn't respond as expected, ask the Agent which apps are connected, then reconnect any that need it.

The Agent can't find an item you expect

The Agent sees only what your account can see in the app. Check the following:

  1. Sign in to the app directly and confirm you can open the item with the same account you connected.

  2. Confirm you connected the account you meant to use. If not, disconnect and connect the right one.

  3. Name the app in your request, so the Agent searches there.

You don't see connections

Connections aren't available in FedRAMP environments.


Related articles