---
search:
  tags:
    - projects
    - POST
seo:
  description: >-
    Creates a new project journal entry to document important project events,…
    Reference for the POST /projects/journal endpoint in the Leadtime Public API
    API.
sidebar:
  badge: POST
  label: Create project journal entry
title: Create project journal entry
type: openapi-operation
---
Creates a new project journal entry to document important project events, observations, feedback, or notes.

**What to include:**
- **projectId** (required): The UUID of the project this entry belongs to
- **body** (required): The journal entry content in HTML or Markdown format. Supports rich text formatting including paragraphs, headings, highlighting, and lists
- **mood** (optional): Mood indicator - Sad (problems/escalations), Neutral (factual), or Happy (wins/progress). Defaults to Neutral if not provided
- **reminder** (optional): ISO 8601 date string for setting a reminder about this entry

**Common use cases:**
- Documenting customer feedback or complaints
- Recording internal findings and observations
- Capturing important conversations or decisions
- Noting risks or opportunities
- Tracking project mood and sentiment over time

**Validation:**
- The projectId must exist and be accessible to the authenticated user
- Body content cannot be empty
- Reminder date must be a valid ISO 8601 date string

**What is returned:**
The complete created journal entry with all fields populated, including the body converted to HTML format.

<Operation source="api-reference" id="projectsjournalcontroller-createprojectjournal" />
