> ## 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="institution" type="string" required>
  School or institution name (max 200 characters)
</ParamField>

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

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

<ParamField body="location" type="string">
  Location of the institution (max 200 characters)
</ParamField>

<ParamField body="startDate" type="string">
  ISO 8601 datetime, e.g. "2018-09-01T00:00:00Z"
</ParamField>

<ParamField body="endDate" type="string">
  ISO 8601 datetime (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
</ParamField>

<ParamField body="grade" type="string">
  Grade or classification (max 50 characters)
</ParamField>

<ParamField body="gpa" type="number">
  GPA value
</ParamField>

### Query Parameters

<ParamField query="cvId" type="string">
  Target a specific resume by its id (from `list-resumes`). Omit to use your base/default resume; the resume must be self-contained.
</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 '{
    "institution": "Stanford University",
    "degree": "Bachelor of Science",
    "fieldOfStudy": "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..."
}
```