# moveOpportunityStage (/api/reference/mutations/move-opportunity-stage)

Give an opportunity a stage. Every stage it is given is written to its stage log with who gave it. Moving it to the stage it is at changes nothing and logs nothing: `opportunityStageEvent` is then null. A move to `LOST` needs a reason, from the input or already on the opportunity (`LOST_REASON_REQUIRED`).

```graphql
moveOpportunityStage(
  input: MoveOpportunityStageInput!
): MoveOpportunityStagePayload!
```

### Arguments [#arguments]

#### [`moveOpportunityStage.input`](#input) · [`MoveOpportunityStageInput!`](/api/reference/inputs/move-opportunity-stage-input) `non-null` `input` [#input]
The opportunity and the stage to give it.

### Type [#type]

#### [`MoveOpportunityStagePayload`](/api/reference/objects/move-opportunity-stage-payload) `object` [#moveopportunitystagepayload-object]
The opportunity at its new stage.