curl --request POST \
--url https://app.marro.si/api/v1/leads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"fields": {
"name": "Priya Sharma",
"phone": "+919812345678",
"city": "Hyderabad",
"source": 3,
"preferred_time": "evening"
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
fields: {
name: 'Priya Sharma',
phone: '+919812345678',
city: 'Hyderabad',
source: 3,
preferred_time: 'evening'
}
})
};
fetch('https://app.marro.si/api/v1/leads', 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/leads",
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([
'fields' => [
'name' => 'Priya Sharma',
'phone' => '+919812345678',
'city' => 'Hyderabad',
'source' => 3,
'preferred_time' => 'evening'
]
]),
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/leads"
payload = { "fields": {
"name": "Priya Sharma",
"phone": "+919812345678",
"city": "Hyderabad",
"source": 3,
"preferred_time": "evening"
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"lead": {
"id": 1842,
"name": "Priya Sharma",
"phone": "+919812345678",
"email": "priya@example.com",
"stageId": 7,
"pipelineId": 2,
"sourceId": 3,
"assignedTo": 21,
"stage": {
"id": 7,
"name": "Follow Up",
"meaning": "open"
},
"pipeline": {
"id": 2,
"name": "Main pipeline"
},
"source": {
"id": 3,
"name": "Website"
},
"owner": {
"id": 21,
"name": "Ravi Kumar"
},
"branchId": 4,
"branch": {
"id": 4,
"name": "Hyderabad",
"code": "HYD"
},
"fields": {
"city": "Hyderabad",
"interest": "Premium plan",
"preferred_time": "evening"
},
"createdAt": "2026-09-20T04:45:00Z",
"updatedAt": "2026-09-24T03:32:11Z"
}
}{
"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 lead
Creates a lead with the organization’s own field rules: required fields, option lists and formats are checked exactly as in the app. The lead starts in the starting stage unless you give one, and without an owner the organization’s assignment rules pick one. Phone number and email are unique per organization, so a retry of the same lead returns DUPLICATE_LEAD with the existing ID instead of creating a second.
Scope: leads.write.
curl --request POST \
--url https://app.marro.si/api/v1/leads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"fields": {
"name": "Priya Sharma",
"phone": "+919812345678",
"city": "Hyderabad",
"source": 3,
"preferred_time": "evening"
}
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
fields: {
name: 'Priya Sharma',
phone: '+919812345678',
city: 'Hyderabad',
source: 3,
preferred_time: 'evening'
}
})
};
fetch('https://app.marro.si/api/v1/leads', 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/leads",
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([
'fields' => [
'name' => 'Priya Sharma',
'phone' => '+919812345678',
'city' => 'Hyderabad',
'source' => 3,
'preferred_time' => 'evening'
]
]),
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/leads"
payload = { "fields": {
"name": "Priya Sharma",
"phone": "+919812345678",
"city": "Hyderabad",
"source": 3,
"preferred_time": "evening"
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"lead": {
"id": 1842,
"name": "Priya Sharma",
"phone": "+919812345678",
"email": "priya@example.com",
"stageId": 7,
"pipelineId": 2,
"sourceId": 3,
"assignedTo": 21,
"stage": {
"id": 7,
"name": "Follow Up",
"meaning": "open"
},
"pipeline": {
"id": 2,
"name": "Main pipeline"
},
"source": {
"id": 3,
"name": "Website"
},
"owner": {
"id": 21,
"name": "Ravi Kumar"
},
"branchId": 4,
"branch": {
"id": 4,
"name": "Hyderabad",
"code": "HYD"
},
"fields": {
"city": "Hyderabad",
"interest": "Premium plan",
"preferred_time": "evening"
},
"createdAt": "2026-09-20T04:45:00Z",
"updatedAt": "2026-09-24T03:32:11Z"
}
}{
"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)).