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

> Create a new education entry

## Overview

The Create Education endpoint lets you add a new education entry to your Mokaru account.

**Common use cases:**

* **AI agent profile building** - automatically add education extracted from a LinkedIn profile or resume.
* **Profile completion** - add education details to strengthen your career profile.
* **Bulk import** - add education entries from a spreadsheet or external system.

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

## Request

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

### Body Parameters

<ParamField body="school" type="string" required>
  School or institution name (max 200 characters)
</ParamField>

<ParamField body="degree" type="string">
  Degree type, e.g. "Bachelor of Science" (max 200 characters)
</ParamField>

<ParamField body="field" type="string">
  Field of study, e.g. "Computer Science" (max 200 characters)
</ParamField>

<ParamField body="startDate" type="string">
  ISO 8601 date string (e.g. "2018-09-01")
</ParamField>

<ParamField body="endDate" type="string">
  ISO 8601 date string (null or omit if currently enrolled)
</ParamField>

<ParamField body="isCurrent" type="boolean">
  Whether currently enrolled (default: false)
</ParamField>

<ParamField body="description" type="string">
  Additional details (max 5000 characters)
</ParamField>

### Example

```bash theme={null}
curl -X POST "https://api.mokaru.ai/v1/education" \
  -H "Authorization: Bearer mk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "school": "Stanford University",
    "degree": "Bachelor of Science",
    "field": "Computer Science",
    "startDate": "2018-09-01",
    "endDate": "2022-06-15",
    "description": "Graduated with honors"
  }'
```

## Response

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

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