> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mokaru.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Contact

> Create a new contact

## 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.

<Note>
  **Scope required:** `contacts:write` | **Rate limit:** 20 requests/min
</Note>

## Request

```bash theme={null}
POST /v1/contacts
```

### Body Parameters

<ParamField body="firstName" type="string" required>
  First name (max 100 characters)
</ParamField>

<ParamField body="lastName" type="string" required>
  Last name (max 100 characters)
</ParamField>

<ParamField body="jobTitle" type="string">
  Contact's job title (max 200 characters)
</ParamField>

<ParamField body="company" type="string">
  Company name (max 200 characters)
</ParamField>

<ParamField body="relationship" type="string">
  Relationship type. One of: `RECRUITER`, `HIRING_MANAGER`, `HR_MANAGER`, `TEAM_LEAD`, `DEPARTMENT_HEAD`, `CEO_FOUNDER`, `COLLEAGUE`, `FRIEND`, `REFERRAL`, `OTHER`
</ParamField>

<ParamField body="email" type="string">
  Email address (max 200 characters)
</ParamField>

<ParamField body="phone" type="string">
  Phone number (max 50 characters)
</ParamField>

<ParamField body="linkedIn" type="string">
  LinkedIn profile URL (max 500 characters)
</ParamField>

### Example

```bash theme={null}
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

<ResponseField name="success" type="boolean">Whether the contact was created</ResponseField>
<ResponseField name="id" type="string">The new contact's unique ID</ResponseField>

```json theme={null}
{
  "success": true,
  "id": "clx1234..."
}
```