Skip to main content
PATCH
Update a customer or opportunity

Authorizations

Authorization
string
header
required

An organization API key, created in Settings → Integrations → API keys. Keys start with mk_live_. Marro stores only a hash of a key, so it is shown once, when it is created: copy it then. Revoking a key ends its access at once. To replace a key without downtime, create the new one, switch your server to it, then revoke the old one. Changes made with a key appear on the lead’s timeline as made by the person who created the key, via the API. Scopes: objects.records.read (Read custom objects), objects.records.write (Create and update custom-object records), objects.records.delete (Delete custom-object records), leads.read (Read leads), leads.write (Create and update leads), leads.capture (Capture leads), crm.records.read (Read customers and opportunities), crm.records.write (Create and update customers and opportunities), reports.read (Read reports), money.read (Read products, quotes, invoices and payments), money.write (Create quotes and invoices and record payments), agent.tools (AI agent tools (MCP)).

Scopes

crm.records.write

Path Parameters

kind
integer
required

contacts, companies or opportunities

Required range: x >= 1
recordId
integer
required

Positive record ID

Required range: x >= 1

Body

application/json
version
integer
required
Required range: x <= 9007199254740991
name
string
Required string length: 1 - 200
email
string<email> | null
Maximum string length: 320
Pattern: ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
phone
string | null
Maximum string length: 40
customFields
object
accountId
integer | null
Required range: 0 < x <= 9007199254740991
ownerId
integer
Required range: x <= 9007199254740991
notes
string | null
Maximum string length: 5000

Response

The requested records, fields, or saved ID and version.

id
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
version
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991