Skip to main content
POST
Create a invoice

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

money.write

Body

application/json
issueDate
string
required

YYYY-MM-DD.

Pattern: ^\d{4}-\d{2}-\d{2}$
lines
object[]
required
Required array length: 1 - 100 elements
leadId
integer | null
Required range: 0 < x <= 2147483647
dueDate
string | null

YYYY-MM-DD.

Pattern: ^\d{4}-\d{2}-\d{2}$
customer
object

Left out: taken from the lead.

placeOfSupply
string | null
Pattern: ^\d{2}$
notes
string
Maximum string length: 4000
terms
string
Maximum string length: 4000
issue
boolean

true: give it its number and mark it sent at once. Otherwise it stays a draft.

Response

The invoice as saved.

invoice
object
required