Skip to main content
POST
/
companies
/
{companyId}
/
notes
Create Company Note
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!"
}
'
{
  "_id": "act_42k26Chi3iya8rfjX",
  "teamId": "tea_b4rMsi2trB42WyuWP",
  "companyId": "cpn_9Q9wjZR9R7rs3HE53",
  "type": "annotated",
  "createdAt": "2025-10-28T04:25:00.653Z",
  "note": "could help our GTM team be more productive",
  "sendUserId": "usr_gmHgNGRcGPSTJrDbT",
  "userId": "usr_gmHgNGRcGPSTJrDbT"
}
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

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