Overview
The Outreach integration connects Alysio to a user’s Outreach workspace so Alysio can retrieve accounts, prospects, pipeline stages, opportunities, tasks, users, and engagement activity such as calls and emails through the Outreach API. Once connected, revenue teams can ask natural-language questions like Which prospects entered a stage this weekWhat opportunities are tied to this account
Show calls and emails for a prospect
List my tasks due today This integration is read-only in the current toolset. Alysio can list and query Outreach objects but does not create, update, or delete Outreach records. Pagination uses Outreach’s cursor model. Alysio uses page[size] to control page length and uses the cursor from links.next as page[after] to fetch the next page.
Supported Data and Capabilities
Accounts
List accounts with filtering, sorting, and pagination. Common filters include RegionLocality
Industry
Website
Created or updated date range
Prospects
List prospects with filters such as Account IDStage ID
Created or updated date range Use outreach_list_accounts to resolve account IDs and outreach_list_stages to resolve stage IDs.
Stages
List Outreach stages with filters such as NameClosed status
Created or updated date range
Opportunities
List opportunities with filters such as Account IDStage ID
Prospect ID
Created or updated date range Use list tools to resolve IDs.
Tasks
List tasks with filters such as Account IDProspect ID
Opportunity ID
Call ID
Created or updated date range
Users
List users with filters such as NameCreated or updated date range User IDs are commonly used for call filters.
Calls
List calls with filters such as User IDProspect ID
Opportunity ID
Task ID
Date range Use outreach_list_users to resolve user IDs.
Emails
List emails mailings with filters such as User IDProspect ID
Opportunity ID
Call ID
Task ID
Date range
Authentication
Method
OAuth 2.0 with OutreachAPI Provider
Outreach API v2Base URL
https://api.outreach.io/api/v2Redirect URI
Configured when setting up the Outreach integration in Alysio.The Outreach OAuth application must allow this redirect URI.
Token Handling
OAuth tokens are stored securely and refreshed automatically. Each user connects their own Outreach account, and access is isolated per credential. If the integration is disconnected, Outreach tools become unavailable until the user reconnects.Required Scopes
Alysio requests read access for the Outreach objects and endpoints needed by the integration. Common scopes include accounts.allcalls.read
mailings.all
opportunities.all
opportunityStages.read
profiles.read
prospects.read
stages.read
tasks.read
teams.read
users.read Additional read scopes may be required depending on your Outreach configuration such as sequences and templates.
Pagination Rules
Outreach uses cursor based pagination. Use page[size] to control the number of records returned per request.To fetch the next page, use the exact cursor from the previous response’s links.next URL as page[after]. Do not modify it. Date filtering commonly uses filter[createdAt][gte] and filter[createdAt][lte]
filter[updatedAt][gte] and filter[updatedAt][lte]
MCP Tools
The Outreach MCP provides list-first tools so users can retrieve Outreach data through natural language.outreach_list_accounts
Lists accounts with filtering, sorting, and pagination. Example prompts List our Outreach accountsFind accounts by industry
Show accounts updated this month
outreach_list_prospects
Lists prospects with filtering, sorting, and pagination. Example prompts List prospects in this stageFind prospects for account 123
Show prospects created last week
outreach_list_stages
Lists stages with filtering, sorting, and pagination. Example prompts List Outreach stagesShow closed stages
Find stages with name containing Renewal
outreach_list_opportunities
Lists opportunities with filtering, sorting, and pagination. Example prompts List opportunities for AcmeShow opportunities in stage Negotiation
Find opportunities for this prospect
outreach_list_tasks
Lists tasks with filtering, sorting, and pagination. Example prompts List my tasksShow tasks due this week
Find tasks for this prospect
outreach_list_users
Lists users with filtering, sorting, and pagination. Example prompts List Outreach usersFind user by email
Show users created recently
outreach_get_calls
Lists calls with filtering, sorting, and pagination. Example prompts List calls from last weekShow calls for this prospect
Calls for user 123 this month
outreach_get_emails
Lists emails mailings with filtering, sorting, and pagination. Example prompts List emails to this prospectShow emails sent by this user
Emails related to this opportunity
App Behavior
Outreach data is retrieved on demand. Alysio does not sync Outreach records in the background. Each user request triggers the relevant Outreach API call using that user’s OAuth credential and returns results for that request.Example Workflow
User asks What opportunities do we have for Acme Corp Alysio routes the request to the Outreach MCP. The MCP calls outreach_list_accounts to find Acme Corp and retrieve its account ID. The MCP calls outreach_list_opportunities with filter parameters using that account ID. Outreach returns the matching opportunities. Alysio displays the opportunities and, if links.next is present, can fetch more using the page[after] cursor.Troubleshooting
Outreach Not Connected
The user has not authorized the integration. SolutionReconnect Outreach under Settings → Integrations and complete OAuth.
401 Unauthorized
The token may be invalid, expired, or revoked. SolutionReconnect the Outreach integration in Settings → Integrations.
403 Forbidden
The OAuth app may be missing required scopes. SolutionConfirm the Outreach OAuth app includes read access for accounts, prospects, stages, opportunities, tasks, users, calls, and mailings.
Pagination Not Working
Cursor value is missing or incorrect. SolutionUse the exact page[after] value from links.next in the previous response. Do not hardcode or modify cursor values.
Empty or Partial Results
Filters may be too strict or IDs may be incorrect. SolutionResolve IDs using outreach_list_accounts, outreach_list_stages, outreach_list_prospects, and outreach_list_users, then retry with relaxed filters.