---
title: "Create a new OpportunityStatusChange activity"
method: POST
path: "/activity/status_change/opportunity/"
tags: ["activities.opportunity_status_changes"]
---

# Create a new OpportunityStatusChange activity

`POST /activity/status_change/opportunity/`

Creating an opportunity status change does not change the opportunity's status. It only logs the status change event. This should only be used to import historical status changes from another system.

## Response `200`

Successful response

- OpportunityStatusChangeActivity
  - `_type` string, required
  - `activity_at` string, date-time, nullable, required
  - `contact_id` string, nullable, required
  - `created_by` string, nullable, required
  - `created_by_name` string, nullable
  - `date_created` string, date-time, required
  - `date_updated` string, date-time, required
  - `id` string, required
  - `lead_id` string, nullable, required
  - `new_pipeline_id` string
  - `new_pipeline_name` string
  - `new_status_id` string, required
  - `new_status_label` string
  - `new_status_type` 'won' | 'lost' | 'active'
  - `old_pipeline_id` string
  - `old_pipeline_name` string
  - `old_status_id` string, required
  - `old_status_label` string
  - `old_status_type` 'won' | 'lost' | 'active'
  - `opportunity_confidence` integer, nullable
  - `opportunity_date_won` string, date-time, nullable
  - `opportunity_id` string, nullable, required
  - `opportunity_value` integer, nullable
  - `opportunity_value_currency` string, nullable
  - `opportunity_value_formatted` string, nullable
  - `opportunity_value_period` 'one_time' | 'monthly' | 'annual'
  - `organization_id` string, required
  - `updated_by` string, nullable, required
  - `updated_by_name` string, nullable
  - `user_id` string, nullable, required
  - `user_name` string, nullable
  - `users` string[], required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/close/apis/close-api.md) · [All operations](https://skmtc.net/close/apis/close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/close/close-api/revisions/0dcf3303e9d7/schema)