/salesforce/opportunity/:id

put

https://api.mixmax.com/v1/salesforce/opportunity/{id}

Updates a Salesforce Opportunity. Send the fields you want to change, keyed by Salesforce field API name.

The body must include the Opportunity's Id and a valid CloseDate, even if you aren't changing the close date. The Id in the URL is not used to pick the record. Amount is rounded down to a whole number.

Pass ContactId to add that Contact to the Opportunity as a new Opportunity Contact Role, and mm_IsPrimaryContactRole: true to make it the primary contact.

Requires a personal API token whose user is connected to Salesforce. The Opportunity is updated with that user's Salesforce credentials.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

The record's Salesforce Id.

Body Params

The record's fields, keyed by Salesforce field API name, for example {"LastName": "Lovelace", "Company": "Analytical Engines"}. Salesforce validates the values, including your org's required fields and validation rules. Set OwnerId to myself to make the API caller the record's owner. Use GET /salesforce/syncedFields to see which fields exist in your org.

OwnerId

string

A Salesforce User Id, or myself for the API caller.

string

required

The Salesforce Id of the Opportunity to update.

CloseDate

string

required

The Opportunity's close date, for example 2026-12-31.

ContactId

string

A Contact to add to the Opportunity as a contact role.

mm_IsPrimaryContactRole

boolean

Defaults to false

With ContactId, pass true to make that Contact the primary contact.

Responses

Language

Credentials

Header

Loading…

Response

Choose an example:

application/json

200The Opportunity was updated.

500The update was rejected, by Salesforce or because CloseDate is missing or invalid. A rejected CloseDate returns {"success": false, "message": "Invalid close date"}.