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

> Add a new certificate to your career profile

## Overview

Add a new certificate or credential to the authenticated user's base resume.

**Common use cases:**

* **AI agent profile building** - extract certifications from a LinkedIn export.
* **Career tracking** - log a freshly earned certificate.
* **Verification** - link to the issuing authority's verification page.

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

## Request

```bash theme={null}
POST /v1/certificates
Content-Type: application/json
```

### Body Parameters

<ParamField body="name" type="string" required>
  Certificate name (max 200 characters)
</ParamField>

<ParamField body="issuer" type="string" required>
  Issuing organisation (max 200 characters)
</ParamField>

<ParamField body="description" type="string">
  Free-text description
</ParamField>

<ParamField body="issueDate" type="string">
  ISO 8601 date string when the certificate was issued
</ParamField>

<ParamField body="expiryDate" type="string">
  ISO 8601 date string when the certificate expires (omit if no expiry)
</ParamField>

<ParamField body="credentialId" type="string">
  Credential ID from the issuer (max 200 characters)
</ParamField>

<ParamField body="verificationUrl" type="string">
  URL to verify the certificate (max 500 characters)
</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>

## Response

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