*Workflows › Reference › Actions › CRM*

# Close opportunity

> Closes an opportunity as won or lost, with its reason, and moves it to the matching stage.

## At a glance

| Property | Value |
| --- | --- |
| Domain | `crm` |
| Group in the editor | CRM › Opportunities |
| Runs as | The owner of the workflow, with their permissions |
| Permission | Edit 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_close`) |

ACTION `crm.opportunities.close`

## Inputs

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `opportunityId` | string | Yes |  |
| `outcome` | enum<string> | Yes |  `won`, `lost` |
| `version` | number | Yes |  |
| `toStageId` | string | No |  |
| `wonReason` | string | No |  |
| `lostReason` | enum<string> | No |  `price`, `timing`, `no_budget`, `no_decision`, `lost_to_competitor`, `no_response`, `duplicate`, `other` |
| `lostReasonNote` | string | No |  |

## Outputs

| Name | Type | Description |
| --- | --- | --- |
| `opportunityId` | string |  |
| `status` | enum<string> |  `open`, `won`, `lost` |
| `version` | number |  |

---

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