---
title: "Add new opportunity"
method: POST
path: "/api/v2/organizations/{orgSlug}/opportunities"
tags: ["Opportunities"]
---

# Add new opportunity

`POST /api/v2/organizations/{orgSlug}/opportunities`

## Request

- Base URL: `https://app.officernd.com`
- URL: `https://app.officernd.com/api/v2/organizations/{orgSlug}/opportunities`
- Auth: OAuth 2
  - Authorization code: `https://identity.officernd.com/auth/authorize`
  - Client credentials
  - Token URL: `https://identity.officernd.com/auth/token` scopes: `flex.community.opportunities.create`

Add new opportunity 

 Required scopes: `flex.community.opportunities.create`

## Path parameters

- `orgSlug` string, required

## Request body

- AddOpportunityDto
  - `properties` object: An object that contains all custom properties that can be applied to the item.
  - `name` string, required: The full name of the opportunity.
  - `company` string: The _id of the contact company associated with the opportunity. Either a member or a company is necessary to create an opportunity.
  - `member` string: The _id of the contact member associated with the opportunity. Either a member or a company is necessary to create an opportunity.
  - `status` string: The _id of the status associated with the opportunity.
  - `probability` number: The probability of the deal, it should match the percentage associated with the status of the opportunity.
  - `startDate` string, date-time: The start date of the opportunity.
  - `dealSize` number: The size of the deal in currency.
  - `membersCount` number: The number of members that come with the opportunity.
  - `resources` string[]: Array containing all the _ids of resources associated with the opportunity.
  - `requestedPlans` string[]: Array containing all the _ids of plans that were requested for the opportunity.

## Response `201`

- OpportunityResultDto
  - `properties` object: An object that contains all custom properties that can be applied to the item.
  - `_id` string: The _id of the opportunity.
  - `name` string: The full name of the opportunity.
  - `company` string: The _id of the contact company associated with the opportunity. Either a member or a company is necessary to create an opportunity.
  - `member` string: The _id of the contact member associated with the opportunity. Either a member or a company is necessary to create an opportunity.
  - `status` string: The _id of the status associated with the opportunity.
  - `probability` number: The probability of the deal, it should match the percentage associated with the status of the opportunity.
  - `startDate` string, date-time: The start date of the opportunity.
  - `dealSize` number: The size of the deal in currency.
  - `membersCount` number: The number of members that come with the opportunity.
  - `resources` string: Array containing all the _ids of resources associated with the opportunity.
  - `requestedPlans` string: Array containing all the _ids of plans that were requested for the opportunity.
  - `createdAt` string: The date when the opportunity has been created.
  - `createdBy` string: The id of the user that created the opportunity.
  - `modifiedAt` string: The date of the last update of the opportunity.
  - `modifiedBy` string: The id of user that did the last updated the opportunity.

---

[API](https://skmtc.dev/officernd/apis/community-api.md) - [All operations](https://skmtc.dev/officernd/apis/community-api/llms.txt) - [OpenAPI document](https://skmtc.dev/officernd/apis/community-api/revisions/dad1b7912165?raw)