Update Deal

patch

https://api.apollo.io/api/v1/opportunities/{opportunity_id}

Use the Update Deal endpoint to update the details of existing deals within your team's Apollo account. Deals enable you to track account activity, including monetary values of a deal, deal owners, and deal stages.

To create new deals in your Apollo account, use the Create Deal endpoint instead.

This endpoint also requires a master API key. If you attempt to call the endpoint without a master key, you will receive a 403 response. Refer to Create API Keys to learn how to create a master API key.

Path Params

opportunity_id

string

required

The ID for the deal you want to update.

Each deal in the Apollo database is assigned a unique ID. To find deal IDs, call the List All Deals endpoint and identify the value for id for the desired deal.

Example: 66e09ea8e3cfcf01b2208ec7

Body Params

owner_id

string

The ID for the deal owner within your team's Apollo account. Enter a different ID to update the owner of the deal.

Use the Get a List of Users endpoint to retrieve IDs for all of the users within your Apollo account.

Example: 66302798d03b9601c7934ebf

name

string

Update the name of the deal. This should be a human-readable name.

Example: Massive Q3 Deal

amount

string

The monetary value of the deal. Enter a different value to update the deal amount.

Do not enter commas or currency symbols for the value. The currency is automatically populated by the settings within your Apollo account. Commas are not accepted and result in the deal amount being left blank.

Example: 55123478 (results in a deal value of $55,123,478 if the default currency is USD)

opportunity_stage_id

string

The ID for the deal stage within your team's Apollo account. Enter a different ID to update the deal stage.

Each deal stage is assigned a unique ID. To find deal stage IDs, call the List Deal Stages endpoint and identify the value for id for each stage.

Example: 6095a710bd01d100a506d4bd

closed_date

date

Update the estimated close date for the deal. This can be a future or past date.

The date should be formatted as YYYY-MM-DD.

Example: 2025-10-30

typed_custom_fields

object

Add information to custom fields in Apollo.

Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.

To utilize this parameter successfully, call the Get a List of All Custom Fields endpoint and identify the id value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying id value for the picklist entry that you want to use as the input value.

Example: When the Get a List of All Custom Fields endpoint returns an id of field:

"60c39ed82bd02f01154c470a" (datetime)

then the value passed should be:

{"60c39ed82bd02f01154c470a": "2025-08-07"}

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200200

401401

403403

422422

429429