Batch Update Deals

URL Expired

The URL for this request expired after 30 days.

PublicDealBatchPatchDto

deals

• Type: array of objects
• Required: length between 1 and 100
• Array of deals to update. Each item must include an id field. Maximum 100 items per request.

deals*

• Type: object

• id

  • Type: string
  • Required: ^[0-9a-fA-F]{24}$
  • ID of the deal to update.

• company

  • Type: company object

• comment

  • Type: string

• tags

  • Type: array of strings
  • tags
  • ADD: string

• stageId

  • Type: string

• addedAt

  • Type: string

• dealLead

  • Type: string
  • User ID to assign as deal lead

• fields

  • Type: object
  • Custom field values keyed by field ID. For fields of type company, provide either a company ID or a domain string (e.g. "stripe.com"). For company-list fields, provide an array of company IDs and/or domain strings. If a domain matches an existing company in your organization, the company record is linked directly; otherwise the domain is resolved via external enrichment. For fields of type deal, provide a deal ID. For deal-list fields, provide an array of deal IDs. For contacts-list fields, provide an array of contact IDs.

fields

• Type: object

• people

  • Type: object
  • Contacts linked to the deal by role (advisers, introducer, management). Note: these fields may have different names on the UI.

people

• Type: object

• ADD: object

Responses

• 200 Deals updated successfully
• 400 Invalid request parameters
• 401 Invalid or missing API key
• 404 One or more deals not found
• 500 Internal server error

curl --request PATCH \
     --url https://crm-public-api.app.carta.com/v1/deals/batch \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{"deals":[]}'

Click Try It! to start a request and see the response here! Or choose an example:

• application/json