---
title: "Create a note for a company"
method: POST
path: "/1.0/companies/{companyId}/add-notes"
tags: ["Companies"]
---

# Create a note for a company

`POST /1.0/companies/{companyId}/add-notes`

## Request

- Base URL: `https://api.rocketlane.com/api`
- URL: `https://api.rocketlane.com/api/1.0/companies/{companyId}/add-notes`
- Auth: API key in header `api-key`
- TypeScript: <https://skmtc.dev/rocketlane/apis/rocketlane-api/docs/1.0/companies/:companyId/add-notes/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a note on a NOTE-type custom field for a company.

## Path parameters

- `companyId` integer, required

## Request body

- CompanyNoteCreateRequestAPIEntity: Request to create a note on a company note-type custom field. Use POST /1.0/companies/{companyId}/add-notes, or include in POST /1.0/companies. fieldId must reference a NOTE-type field (GET /1.0/fields). tagIds are optional.
  - `fieldId` integer, required: ID of the note-type field this note belongs to.
  - `noteTitle` string: Optional title for the note.
  - `noteText` string, required: Plain text content of the note.
  - `tagIds` integer[]: Optional tag IDs from the field's available tag options.

## Response `201`

The resource was successfully created in the database.

- CompanyNotePublicResponseAPIEntity: Note on a company note-type custom field. Returned when includeFields=notes is specified.
  - `noteId` integer: Unique identifier of the note.
  - `fieldId` integer: ID of the note-type custom field this note belongs to.
  - `fieldLabel` string: Display name of the note-type field.
  - `noteTitle` string: Optional title of the note.
  - `noteText` string: Plain text content of the note.
  - `tags` CompanyNoteTagPublicResponseEntity[]: Tags selected for this note, resolved from the field's tag options.
    - `tagId` integer: The unique identifier of the tag
    - `label` string: The display label of the tag
    - `color` string: The color associated with the tag
  - `createdAt` integer: Unix timestamp in milliseconds when the note was created.
  - `updatedAt` integer: Unix timestamp in milliseconds when the note was last updated.

## Other responses

- `400`: This error typically happens when the request payload contains an error. If you want to make sure that the request's parameters are named correctly and are the right data types, you can examine the request's syntax.
- `401`: You see this error when trying to access this resource without being authenticated. Check the API request header to make sure it is not empty and has a valid api-key that you acquired from the Rocketlane API Settings tab.
- `404`: If we were unable to locate the resource you were looking for or the proper API endpoint you were looking for, this error would show up.
- `500`: This error denotes that there is an error that occured within our servers. The response body could help narrow down the cause for the error by our support team.

## Changes

- **2026-11-03** `a002a499e6fc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rocketlane/apis/rocketlane-api/changes/1.0/companies/:companyId/add-notes/post.md)

---

[API](https://skmtc.dev/rocketlane/apis/rocketlane-api.md) - [All operations](https://skmtc.dev/rocketlane/apis/rocketlane-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rocketlane/apis/rocketlane-api/revisions/a002a499e6fc?raw)