Skip to main content
POST
/
v1
/
contacts
Create Contact
curl --request POST \
  --url https://api.mokaru.ai/v1/contacts \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "<string>",
  "lastName": "<string>",
  "jobTitle": "<string>",
  "company": "<string>",
  "relationship": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "linkedIn": "<string>"
}
'
{
  "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/min

​
Request

POST /v1/contacts

​
Body Parameters

​
firstName
string
required
First name (max 100 characters)
​
lastName
string
required
Last name (max 100 characters)
​
jobTitle
string
Contact’s job title (max 200 characters)
​
company
string
Company name (max 200 characters)
​
relationship
string
Relationship type. One of: RECRUITER, HIRING_MANAGER, HR_MANAGER, TEAM_LEAD, DEPARTMENT_HEAD, CEO_FOUNDER, COLLEAGUE, FRIEND, REFERRAL, OTHER
​
email
string
Email address (max 200 characters)
​
phone
string
Phone number (max 50 characters)
​
linkedIn
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

​
success
boolean
Whether the contact was created
​
id
string
The new contact’s unique ID
{
  "success": true,
  "id": "clx1234..."
}