Create opportunities

Creates an opportunity in Business Central.

HTTP request

Replace the URL prefix for Business Central depending on environment following the guideline.

POST businesscentralPrefix/companies({id})/opportunities({id})

Request headers

Request body

In the request body, supply a JSON representation of a opportunity object.

Response

If successful, this method returns 201 Created response code and a opportunity object in the response body.

Example

Request

Here's an example of the request.

POST https://{businesscentralPrefix}/api/v2.0/companies({id})/opportunities({id})
Content-type: application/json
{
"number": "OP100101",
"contactNumber": "CT200116",
"salespersonCode": "BC",
"description": "Description"
}

Response

Here's an example of the response.

HTTP/1.1 201 Created
Content-type: application/json
{
"@odata.etag": "W/\"JzQ0O05OZnZiNXpLT1BhTmkvQmduNDBxL1pMR09tdE1aZjVJUVYrYVBWb0VzeDA9MTswMDsn\"",
"id": "563c6d96-cd04-ec11-9310-000d3abb70f9",
"number": "OP100101",
"contactNumber": "CT200116",
"contactName": "David Oliver Lawrence",
"contactCompanyName": "A. Gibson\"s Law Firm",
"salespersonCode": "BC",
"description": "Description",
"status": "Not_x0020_Started",
"closed": false,
"creationDate": "2021-08-24",
"dateClosed": "0001-01-01",
"calculatedCurrentValue": 0,
"chancesOfSuccessPrc": 0,
"completedPrc": 0,
"estimatedClosingDate": "0001-01-01",
"estimatedValue": 0,
"systemCreatedAt": "2021-08-24T11:22:39.02Z",
"lastModifiedDateTime": "2021-08-24T11:22:39.02Z"
}

Related information

Tips for working with the APIs
opportunity
GET opportunity
DELETE opportunity
PATCH opportunity