API referenceCompanies
Add a company note
Add plain text to a company's activity timeline, attributed to the API key creator.
Permissions: Companies: read and write.
Behavior and retry rules
Every successful request adds a new note. Notes have no idempotency key. After a timeout, check the company's timeline before sending the note again. Text is displayed as plain text; HTML is not supported.
POST
/companies/{orgNr}/notesAuthorization
bearerAuth AuthorizationBearer <token>
Create a key in Aventra → Innstillinger → API-nøkler.
In: header
Path Parameters
orgNr*string
Match
^\d{9}$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/companies/923609016/notes" \ -H "Authorization: Bearer $AVENTRA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "text": "Requested a demo through our website. Interested in onboarding in October." }'{ "data": { "id": 44, "company_id": "4d73dca4-7537-4f9c-924e-8bccd354663f", "type": "add_comment", "content": { "text": "Requested a demo through our website. Interested in onboarding in October." }, "user_id": "f52b3fd3-5ff4-4d93-91c5-6ac79e21cdd5", "created_at": "2026-09-05T10:00:00Z" }}See authentication, errors and retry guidance.