---
title: "Create an opportunity"
method: POST
path: "/v1/opportunities"
---

# Create an opportunity

`POST /v1/opportunities`

Supply the opportunity object in the request body and this API will create an opportunity with given details. <br/> **Note**: 'type' parameter is required to use Sales Stage Rules. <br/>**Steps to create/edit Sales Stage Rules** - Opportunities-> Sales Stage Rules.

## Query parameters

- `center_id` string, required
- `opportunity_title` string, required
- `opportunity_description` string
- `opportunity_owner_id` string
- `guest_id` string, required
- `created_by_id` string, required
- `priority_type_id` string
- `status_id` string
- `type` string
- `followup_date` string, date, required
- `expected_close_date` string, date
- `listed_amount` number, double
- `offered_amount` number, double
- `optional_field_1` string
- `optional_field_2` string
- `optional_field_3` string
- `ticket_id (guid)` string
- `change_guest_center` boolean
- `disposition_id` string
- `custom_fields` string
- `lead_source` object
- `lead_source.id` string
- `lead_source.code` string

## Response `200`

200

- object
  - `success` boolean
  - `opportunity_id` string
  - `message` string

## Other responses

- `400` — 400

---

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