curl --request POST \
--url https://app.marro.si/api/v1/quotes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"leadId": 1842,
"issueDate": "2026-11-12",
"issue": true,
"lines": [
{
"productId": 7,
"name": "Teeth whitening",
"quantity": 1,
"unitPrice": 15000,
"discount": "10%",
"gstRate": 18
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
leadId: 1842,
issueDate: '2026-11-12',
issue: true,
lines: [
{
productId: 7,
name: 'Teeth whitening',
quantity: 1,
unitPrice: 15000,
discount: '10%',
gstRate: 18
}
]
})
};
fetch('https://app.marro.si/api/v1/quotes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.marro.si/api/v1/quotes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'leadId' => 1842,
'issueDate' => '2026-11-12',
'issue' => true,
'lines' => [
[
'productId' => 7,
'name' => 'Teeth whitening',
'quantity' => 1,
'unitPrice' => 15000,
'discount' => '10%',
'gstRate' => 18
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}import requests
url = "https://app.marro.si/api/v1/quotes"
payload = {
"leadId": 1842,
"issueDate": "2026-11-12",
"issue": True,
"lines": [
{
"productId": 7,
"name": "Teeth whitening",
"quantity": 1,
"unitPrice": 15000,
"discount": "10%",
"gstRate": 18
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"quote": {
"id": 311,
"kind": "quote",
"number": "QT-0298",
"status": "sent",
"overdue": false,
"leadId": 1842,
"quoteId": null,
"currency": "INR",
"issueDate": "2026-11-12",
"dueDate": "2026-11-19",
"customer": {
"name": "Priya Sharma",
"gstin": null,
"address": "Banjara Hills, Hyderabad",
"stateCode": "36",
"phone": "+919812345678",
"email": "priya@example.com"
},
"supplier": {
"name": "Bright Smiles Dental",
"gstin": "36ABCDE1234F1Z5",
"address": "Jubilee Hills, Hyderabad",
"stateCode": "36",
"phone": null,
"email": "accounts@example.com"
},
"placeOfSupply": "36",
"taxMode": "intra",
"tax": {
"model": "in_gst",
"label": null,
"registrationLabel": null,
"inclusive": false
},
"singleTaxMinor": 0,
"subtotalMinor": 1500000,
"discountMinor": 150000,
"taxableMinor": 1350000,
"cgstMinor": 121500,
"sgstMinor": 121500,
"igstMinor": 0,
"roundOffMinor": 0,
"totalMinor": 1593000,
"paidMinor": 0,
"dueMinor": 0,
"createdAt": "2026-11-12T05:30:00Z"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}Create a quote
A quote for a lead (its customer details are taken from the lead unless given) or for a customer with no lead. Prices are before GST; GST is worked out from the organization’s and the customer’s states. A draft unless issue is true, which gives it its number and marks it sent. Not idempotent: reconcile an uncertain request before retrying.
Scope: money.write.
curl --request POST \
--url https://app.marro.si/api/v1/quotes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"leadId": 1842,
"issueDate": "2026-11-12",
"issue": true,
"lines": [
{
"productId": 7,
"name": "Teeth whitening",
"quantity": 1,
"unitPrice": 15000,
"discount": "10%",
"gstRate": 18
}
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
leadId: 1842,
issueDate: '2026-11-12',
issue: true,
lines: [
{
productId: 7,
name: 'Teeth whitening',
quantity: 1,
unitPrice: 15000,
discount: '10%',
gstRate: 18
}
]
})
};
fetch('https://app.marro.si/api/v1/quotes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.marro.si/api/v1/quotes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'leadId' => 1842,
'issueDate' => '2026-11-12',
'issue' => true,
'lines' => [
[
'productId' => 7,
'name' => 'Teeth whitening',
'quantity' => 1,
'unitPrice' => 15000,
'discount' => '10%',
'gstRate' => 18
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}import requests
url = "https://app.marro.si/api/v1/quotes"
payload = {
"leadId": 1842,
"issueDate": "2026-11-12",
"issue": True,
"lines": [
{
"productId": 7,
"name": "Teeth whitening",
"quantity": 1,
"unitPrice": 15000,
"discount": "10%",
"gstRate": 18
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"quote": {
"id": 311,
"kind": "quote",
"number": "QT-0298",
"status": "sent",
"overdue": false,
"leadId": 1842,
"quoteId": null,
"currency": "INR",
"issueDate": "2026-11-12",
"dueDate": "2026-11-19",
"customer": {
"name": "Priya Sharma",
"gstin": null,
"address": "Banjara Hills, Hyderabad",
"stateCode": "36",
"phone": "+919812345678",
"email": "priya@example.com"
},
"supplier": {
"name": "Bright Smiles Dental",
"gstin": "36ABCDE1234F1Z5",
"address": "Jubilee Hills, Hyderabad",
"stateCode": "36",
"phone": null,
"email": "accounts@example.com"
},
"placeOfSupply": "36",
"taxMode": "intra",
"tax": {
"model": "in_gst",
"label": null,
"registrationLabel": null,
"inclusive": false
},
"singleTaxMinor": 0,
"subtotalMinor": 1500000,
"discountMinor": 150000,
"taxableMinor": 1350000,
"cgstMinor": 121500,
"sgstMinor": 121500,
"igstMinor": 0,
"roundOffMinor": 0,
"totalMinor": 1593000,
"paidMinor": 0,
"dueMinor": 0,
"createdAt": "2026-11-12T05:30:00Z"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {}
}
}Authorizations
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)).