Update an opportunity

QA Environment

https://qa-api.kiolinkapp.com

PATCH

/v1/xc/salesforce/opportunities/{id}

Last modified:2026-09-25 18:22:20

Maintainer:José María Esparza Arévalo

Required Permission(s):xc-request-update

Updates one or more fields of an existing Salesforce Opportunity. All fields are optional; only the fields provided are changed.

Request

Authorization

API Key

Add parameter in header

authorization

Example:

authorization: ********************

Path Params

Body Params application/jsonRequired

Examples

Full ExampleMinimal Example

{
  "opportunity_name": "UP-META TIKTOK/CARRIER-1XC-RMS MEX2 #RQ-2026-XXXXXXXXXXX",
  "account_id": "001PU00000QySgOYAV",
  "opportunity_currency_iso_code": "USD",
  "close_date": "01-06-2026",
  "stage": "Detección de necesidades",
  "contract_term_months": 12,
  "service_type": "XC",
  "num_of_requests": 7,
  "invoicing_company": "K021 - POWERHOST SOLUTIONS S DE RL DE CV",
  "service_delivery_manager_id": "005Hs00000Cqvf6IAB",
  "assigned_service_delivery_id": "005Hs00000CqvfEIAR",
  "factory_opportunity": true,
  "is_renewable": false,
  "description": "Cliente solicita 7XC en MEX1 entre Meta y Alestra, Telmex",
  "forecast_category_dc": "Commit",
  "forecast_category": "Commit",
  "nrc_start_date": "01-06-2026",
  "mrc_start_date": "01-06-2026",
  "contracted_racks": 0,
  "new_kws": 0,
  "contracted_mt2": 0,
  "renewed_kws": 0,
  "kws_price": 0,
  "datacenter": "MEX1",
  "dcs_project_classification": "Retail",
  "opportunity_type": "XC/IC",
  "assigned_pm_id": "005PU00000AKvvdYAD",
  "assigned_pmo": "Roberto Macias Valadez"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Full ExampleMinimal Example

curl --location --request PATCH 'https://qa-api.kiolinkapp.com/v1/xc/salesforce/opportunities/' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "opportunity_name": "UP-META TIKTOK/CARRIER-1XC-RMS MEX2 #RQ-2026-XXXXXXXXXXX",
  "account_id": "001PU00000QySgOYAV",
  "opportunity_currency_iso_code": "USD",
  "close_date": "01-06-2026",
  "stage": "Detección de necesidades",
  "contract_term_months": 12,
  "service_type": "XC",
  "num_of_requests": 7,
  "invoicing_company": "K021 - POWERHOST SOLUTIONS S DE RL DE CV",
  "service_delivery_manager_id": "005Hs00000Cqvf6IAB",
  "assigned_service_delivery_id": "005Hs00000CqvfEIAR",
  "factory_opportunity": true,
  "is_renewable": false,
  "description": "Cliente solicita 7XC en MEX1 entre Meta y Alestra, Telmex",
  "forecast_category_dc": "Commit",
  "forecast_category": "Commit",
  "nrc_start_date": "01-06-2026",
  "mrc_start_date": "01-06-2026",
  "contracted_racks": 0,
  "new_kws": 0,
  "contracted_mt2": 0,
  "renewed_kws": 0,
  "kws_price": 0,
  "datacenter": "MEX1",
  "dcs_project_classification": "Retail",
  "opportunity_type": "XC/IC",
  "assigned_pm_id": "005PU00000AKvvdYAD",
  "assigned_pmo": "Roberto Macias Valadez"
}'

Responses

🟢200

application/json

Result of the operation.

Bodyapplication/json

Example

{
    "id": "006QL00000ZME9sYAH",
    "opportunity_number": "Op-504100",
    "success": true
}

Modified at 2026-09-25 18:22:20

Create an opportunity

Overview