*Workflows › Reference › Actions › CRM*

# Find opportunity

> Gets an opportunity's detail, optionally with its stage history.

## At a glance

| Property | Value |
| --- | --- |
| Domain | `crm` |
| Group in the editor | CRM › Opportunities |
| Runs as | The owner of the workflow, with their permissions |
| Permission | View access to CRM. Administrators always pass; a module outside the plan blocks everyone. |
| Add-on | CRM |
| Destructive | No: the public MCP catalogue does not mark it as destructive |
| Also available in | REST API, MCP (`filmo_crm_opportunities_get`) |

ACTION `crm.opportunities.find`

## Inputs

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `opportunityId` | string | Yes |  |
| `includeHistory` | boolean | No |  |

## Outputs

| Name | Type | Description |
| --- | --- | --- |
| `opportunityId` | string |  |
| `identifier` | string |  |
| `name` | string |  |
| `status` | enum<string> |  `open`, `won`, `lost` |
| `amount` | string |  |
| `currency` | string |  |
| `pipelineId` | string |  |
| `pipelineName` | string |  |
| `stageId` | string |  |
| `stageName` | string |  |
| `stageType` | enum<string> |  `open`, `won`, `lost` |
| `effectiveProbability` | number |  |
| `weightedAmount` | string |  |
| `daysInStage` | number |  |
| `expectedCloseDate` | string |  |
| `contactName` | string |  |
| `companyName` | string |  |
| `ownerName` | string |  |
| `source` | enum<string> |  `inbound_email`, `website_form`, `referral`, `cold_outreach`, `event`, `social`, `existing_customer`, `partner`, `other` |
| `createdAt` | string |  |
| `updatedAt` | string |  |
| `description` | string |  |
| `version` | number |  |
| `collaboratorStaffIds` | string[] |  |
| `quoteIds` | string[] |  |
| `stageHistory` | object[] |  |
| `stageHistory.fromStageId` | string |  |
| `stageHistory.toStageId` | string |  |
| `stageHistory.toStatus` | string |  |
| `stageHistory.daysInPrevStage` | number |  |
| `stageHistory.movedAt` | string |  |
| `stageHistory.note` | string |  |

---

Canonical URL: https://docs.filmo.io/workflows/reference/actions/crm-opportunities-find  
Last updated: 2026-10-25