✅ 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.
In Vanta, select Vanta Agent in the left navigation, then select Settings.
Select the Connections tab.
Find the app you want to connect.
Select Connect next to the app. While one connection is in progress, the other Connect buttons are unavailable.
Vanta takes you to the app. Sign in if prompted, then review the access request and approve it.
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
Open the Connections tab in Vanta Agent settings.
Select Reconnect next to the app.
Sign in to the app if prompted, then approve the access request.
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:
Sign in to the app directly and confirm you can open the item with the same account you connected.
Confirm you connected the account you meant to use. If not, disconnect and connect the right one.
Name the app in your request, so the Agent searches there.
You don't see connections
Connections aren't available in FedRAMP environments.
