Create Contact
curl --request POST \
--url https://api.mokaru.ai/v1/contacts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"firstName": "<string>",
"lastName": "<string>",
"jobTitle": "<string>",
"company": "<string>",
"relationship": "<string>",
"email": "<string>",
"phone": "<string>",
"linkedIn": "<string>"
}
'import requests
url = "https://api.mokaru.ai/v1/contacts"
payload = {
"firstName": "<string>",
"lastName": "<string>",
"jobTitle": "<string>",
"company": "<string>",
"relationship": "<string>",
"email": "<string>",
"phone": "<string>",
"linkedIn": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
firstName: '<string>',
lastName: '<string>',
jobTitle: '<string>',
company: '<string>',
relationship: '<string>',
email: '<string>',
phone: '<string>',
linkedIn: '<string>'
})
};
fetch('https://api.mokaru.ai/v1/contacts', 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://api.mokaru.ai/v1/contacts",
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([
'firstName' => '<string>',
'lastName' => '<string>',
'jobTitle' => '<string>',
'company' => '<string>',
'relationship' => '<string>',
'email' => '<string>',
'phone' => '<string>',
'linkedIn' => '<string>'
]),
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;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.mokaru.ai/v1/contacts"
payload := strings.NewReader("{\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"jobTitle\": \"<string>\",\n \"company\": \"<string>\",\n \"relationship\": \"<string>\",\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"linkedIn\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.mokaru.ai/v1/contacts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"jobTitle\": \"<string>\",\n \"company\": \"<string>\",\n \"relationship\": \"<string>\",\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"linkedIn\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mokaru.ai/v1/contacts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"jobTitle\": \"<string>\",\n \"company\": \"<string>\",\n \"relationship\": \"<string>\",\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"linkedIn\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"id": "<string>"
}Contacts
Create Contact
Create a new contact
POST
/
v1
/
contacts
Create Contact
curl --request POST \
--url https://api.mokaru.ai/v1/contacts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"firstName": "<string>",
"lastName": "<string>",
"jobTitle": "<string>",
"company": "<string>",
"relationship": "<string>",
"email": "<string>",
"phone": "<string>",
"linkedIn": "<string>"
}
'import requests
url = "https://api.mokaru.ai/v1/contacts"
payload = {
"firstName": "<string>",
"lastName": "<string>",
"jobTitle": "<string>",
"company": "<string>",
"relationship": "<string>",
"email": "<string>",
"phone": "<string>",
"linkedIn": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
firstName: '<string>',
lastName: '<string>',
jobTitle: '<string>',
company: '<string>',
relationship: '<string>',
email: '<string>',
phone: '<string>',
linkedIn: '<string>'
})
};
fetch('https://api.mokaru.ai/v1/contacts', 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://api.mokaru.ai/v1/contacts",
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([
'firstName' => '<string>',
'lastName' => '<string>',
'jobTitle' => '<string>',
'company' => '<string>',
'relationship' => '<string>',
'email' => '<string>',
'phone' => '<string>',
'linkedIn' => '<string>'
]),
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;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.mokaru.ai/v1/contacts"
payload := strings.NewReader("{\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"jobTitle\": \"<string>\",\n \"company\": \"<string>\",\n \"relationship\": \"<string>\",\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"linkedIn\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.mokaru.ai/v1/contacts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"jobTitle\": \"<string>\",\n \"company\": \"<string>\",\n \"relationship\": \"<string>\",\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"linkedIn\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.mokaru.ai/v1/contacts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"firstName\": \"<string>\",\n \"lastName\": \"<string>\",\n \"jobTitle\": \"<string>\",\n \"company\": \"<string>\",\n \"relationship\": \"<string>\",\n \"email\": \"<string>\",\n \"phone\": \"<string>\",\n \"linkedIn\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"id": "<string>"
}Overview
The Create Contact endpoint lets you add a new networking contact to your Mokaru account. Common use cases:- AI agent contact capture - save contacts from LinkedIn conversations or email threads automatically.
- Post-interview logging - record interviewer details after a call.
- Bulk import - add contacts from a spreadsheet or CRM via automation.
Scope required:
contacts:write | Rate limit: 20 requests/minRequest
POST /v1/contacts
Body Parameters
string
required
First name (max 100 characters)
string
required
Last name (max 100 characters)
string
Contact’s job title (max 200 characters)
string
Company name (max 200 characters)
string
Relationship type. One of:
RECRUITER, HIRING_MANAGER, HR_MANAGER, TEAM_LEAD, DEPARTMENT_HEAD, CEO_FOUNDER, COLLEAGUE, FRIEND, REFERRAL, OTHERstring
Email address (max 200 characters)
string
Phone number (max 50 characters)
string
LinkedIn profile URL (max 500 characters)
Example
curl -X POST "https://api.mokaru.ai/v1/contacts" \
-H "Authorization: Bearer mk_your_key" \
-H "Content-Type: application/json" \
-d '{
"firstName": "Sarah",
"lastName": "Jones",
"jobTitle": "Engineering Manager",
"company": "Acme Corp",
"relationship": "HIRING_MANAGER",
"email": "sarah@acme.com"
}'
Response
boolean
Whether the contact was created
string
The new contact’s unique ID
{
"success": true,
"id": "clx1234..."
}
Was this page helpful?
⌘I
