> ## Documentation Index > Fetch the complete documentation index at: https://docs.alysio.ai/llms.txt > Use this file to discover all available pages before exploring further. # Outreach > Connect Alysio to Outreach using OAuth 2.0 ## 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 week\ What 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 Region\ Locality\ Industry\ Website\ Created or updated date range *** ### Prospects List prospects with filters such as Account ID\ Stage 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 Name\ Closed status\ Created or updated date range *** ### Opportunities List opportunities with filters such as Account ID\ Stage ID\ Prospect ID\ Created or updated date range Use list tools to resolve IDs. *** ### Tasks List tasks with filters such as Account ID\ Prospect ID\ Opportunity ID\ Call ID\ Created or updated date range *** ### Users List users with filters such as Name\ Email\ Created or updated date range User IDs are commonly used for call filters. *** ### Calls List calls with filters such as User ID\ Prospect ID\ Opportunity ID\ Task ID\ Date range Use outreach\_list\_users to resolve user IDs. *** ### Emails List emails mailings with filters such as User ID\ Prospect ID\ Opportunity ID\ Call ID\ Task ID\ Date range *** ## Authentication ### Method OAuth 2.0 with Outreach ### API Provider Outreach API v2 ### Base URL [https://api.outreach.io/api/v2](https://api.outreach.io/api/v2) ### Redirect 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.all\ calls.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 accounts\ Find accounts by industry\ Show accounts updated this month *** ### outreach\_list\_prospects Lists prospects with filtering, sorting, and pagination. Example prompts List prospects in this stage\ Find prospects for account 123\ Show prospects created last week *** ### outreach\_list\_stages Lists stages with filtering, sorting, and pagination. Example prompts List Outreach stages\ Show closed stages\ Find stages with name containing Renewal *** ### outreach\_list\_opportunities Lists opportunities with filtering, sorting, and pagination. Example prompts List opportunities for Acme\ Show opportunities in stage Negotiation\ Find opportunities for this prospect *** ### outreach\_list\_tasks Lists tasks with filtering, sorting, and pagination. Example prompts List my tasks\ Show tasks due this week\ Find tasks for this prospect *** ### outreach\_list\_users Lists users with filtering, sorting, and pagination. Example prompts List Outreach users\ Find user by email\ Show users created recently *** ### outreach\_get\_calls Lists calls with filtering, sorting, and pagination. Example prompts List calls from last week\ Show 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 prospect\ Show 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. Solution\ Reconnect Outreach under Settings → Integrations and complete OAuth. *** ### 401 Unauthorized The token may be invalid, expired, or revoked. Solution\ Reconnect the Outreach integration in Settings → Integrations. *** ### 403 Forbidden The OAuth app may be missing required scopes. Solution\ Confirm 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. Solution\ Use 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. Solution\ Resolve IDs using outreach\_list\_accounts, outreach\_list\_stages, outreach\_list\_prospects, and outreach\_list\_users, then retry with relaxed filters. *** ## Support For help configuring or troubleshooting the Outreach integration, contact [support@alysio.ai](mailto:support@alysio.ai)