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.
This endpoint creates a new note for a specific company.

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