---
title: "Create an Opportunity"
method: POST
path: "/api/v1/opportunity"
tags: ["Quote Management"]
---

# Create an Opportunity

`POST /api/v1/opportunity`

Creates a new opportunity within DealHub, typically used for renewal automation.

## Request body

- CreateOpportunityRequest
  - `external_opportunity_id` string, required — CRM opportunity ID.
  - `external_opportunity_name` string, required — CRM opportunity name.
  - `opportunity_owner` OpportunityOwner, required — Information about the opportunity owner.
    - `external_user_id` string, required — The CRM user ID. Represents an employee of the organization integrating with DealHub.
    - `login` string — The user's login identifier. If not provided, the system uses the email as the login. The login must be unique across all DealHub tenants.
    - `email` string, required — The primary email address of the user.
    - `name` string, required — The user's full name.
    - `position` string — The user's role or job title within the organization.
    - `phone` string — The user's phone number.
    - `mobile` string — The user's mobile phone number.
    - `fax` string — The user's fax number.
    - `company` string — The name of the user's company.
    - `street` string — The street address of the user.
    - `city` string — The city where the user is located.
    - `state` string — The state where the user is located.
    - `country` string — The user's country.
    - `postal_code` string — The postal code of the user's location.
    - `user_manager_login` string — The login ID of the user's manager.
  - `currency` string, required — Opportunity currency (ISO code).
  - `external_customer_id` string, required — CRM customer ID (buyer account).
  - `customer_name` string, required — CRM customer name.

## Response `200`

Success. The opportunity was created.

## Other responses

- `400` — Bad Request. The opportunity with the specified ID already exists or the payload is invalid.
- `403` — Forbidden. Invalid or missing authentication token.

---

[API](https://skmtc.net/dealhub/apis/quote-api.md) · [All operations](https://skmtc.net/dealhub/apis/quote-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dealhub/quote-api/versions/c30f5b9fbfab/schema)