Home

Create a Note

Use this endpoint to create a new note by sending its content in the request body.

  • You must have a valid API key.
  • Ensure you include the Content-Type: application/json header.
  1. Send a POST request to /notes.
  2. In the request body, provide the note details in JSON format:
    • title (string): The title of the note.
    • content (string): The content of the note.
    • tags (array, optional): A list of tags.

If successful, the API returns a 201 Created status and the newly created note object in JSON.

Request (cURL):


curl -X POST "https://api.helionote.com/v1/notes" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Meeting Notes",
"content": "Discuss project roadmap and deadlines.",
"tags": ["work", "planning"]
}'

Response:


{
"id": "789",
"title": "Meeting Notes",
"content": "Discuss project roadmap and deadlines.",
"tags": ["work", "planning"],
"created_at": "2025-08-18T10:23:45Z"
}