Create Company Note

Creates a new note attached to a specific company.

POST /companies/{companyId}/notes

Create Company Note

cURL

curl --request POST \
  --url https://api.lemlist.com/api/companies/{companyId}/notes \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "note": "Note created from the API!"
}
'

200

{
  "_id": "act_j0NrG6rYEPP9TMmWC",
  "teamId": "tea_8QvkOiBfPdb2ZRhHi",
  "companyId": "cpn_Qf4CJuUrNUNmHm6uZ",
  "type": "annotated",
  "createdAt": "2025-10-28T04:25:00.653Z",
  "note": "could help our GTM team be more productive",
  "sendUserId": "usr_ahfFktBBHUIxbVG5P",
  "userId": "usr_ahfFktBBHUIxbVG5P"
}

This endpoint uses the Company Note object.

Authorizations

Authorization · string · header · required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

companyId · string · required

The unique identifier of the company

Body

application/json

note · string · required

The note content

Response

200

application/json

Success

A text note attached to a company record to store information.

_id · string

Unique note identifier

teamId · string

Team ID that owns the company

companyId · string

Parent company ID

note · string

Note text content

type · string

Type of note or activity (e.g., 'annotated')

userId · string

ID of the user who created the note

sendUserId · string

ID of the sending user if applicable

createdAt · string<date-time>

Creation timestamp

updatedAt · string<date-time>

Last update timestamp