---
title: "Update the Deal."
method: POST
path: "/api/external/deal/update"
tags: ["Deal APIs"]
---

# Update the Deal.

`POST /api/external/deal/update`

<br/><b>Please find the format of custom field input below.</b><br/><li> Single select:<br/>{<br/>"id": single_select_cf_id,<br/>"value": "string"<br/>}<br/></li><br/><br/><li> Multi select :<br/>{<br/>"id": multi_select_cf_id,<br/>"value": ["string1", "string2"]<br/>}<br/></li><br/><br/><li> Short/Long text:<br/>{<br/>"id": short_text_cf_id,<br/>"value": "text"<br/>}</li><br/><br/><li> Money:<br/>{<br/>"id": money custom field id,<br/>"value": {"number": Integer(The amount), "currency": "string(Currency code eg. USD, GBP)"}<br/>}<br/><br/><li> Money Range:<br/>{<br/>"id": money reange custom field id,<br/>"value": {"number1": Integer(Starting Amount), "number2": "Ending Amount", "currency": "string(Currency code eg. USD, GBP)"}<br/>}<br/><br/><li> Number/Date:<br/>{<br/>"id": cf_id,<br/>"value": number/date to store<br/>}<br/></li><br/><br/><li> Yes No:<br/>{<br/>"id": yes_no_cf_id,<br/>"value": 0 for No and 1 for Yes<br/>}</li><br/><br/><li> Profile :<br/>{<br/>"id": profile_cf_id,<br/>"value": [{"id": profile_id, "type": entity_type(Candidate, Contact, Company)}]<br/>}</li><br/><br/><li> Parent-Child :<br/>{<br/>"id": parent-child-cf-id,<br/>"value": [{"name": "parent_name", "children": ["child1", "child2"]}]<br/>}</li><br/><br/><li> Users :<br/>{<br/>"id": users_cf_id,<br/>"value": [integer_user_id_1, integer_user_id_1]<br/>}</li><br/>

## Headers

- `RF-Api-Key` string, required
- `content-type` string

## Request body

- object
  - `amount` integer — Amount associated with the Deal.
  - `amount_currency` string — Currency of Amount.(Must be 3 letter iso codes. e.g "USD", "AUD")
  - `client_company` string — Name of the Company associated with the Deal.
  - `close_date` string — Deal close date in format YYYY-MM-DD. (Required only if moving to stage CLOSED LOST or CLOSED WON)
  - `custom_fields` object[]
    - `id` integer
    - `value` object[]
      - `id` string
      - `type` string
  - `deal_owner_id` integer — Owner ID associated with the Deal.
  - `entities` object[]
    - `id` integer
    - `name` string
    - `type` integer
  - `expected_close_date` string — Deal expected close date in format YYYY-MM-DD.
  - `id` integer — ID of a Deal to update.
  - `lost_reason` unknown[]
    - unknown
  - `name` string — Name of the Deal.
  - `stage_id` integer — Stage ID associated with the Deal(You can send either Stage ID or Stage Name.).
  - `stage_name` string — Stage name of the Deal(You can send either Stage ID or Stage Name.).
  - `user_id` integer — ID of a User moving the Stage.
  - `won_reason` unknown[]
    - unknown

## Response `200`

Auto generated using Swagger Inspector

---

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