Save a Note

curl --request POST \
  --url https://api.opennous.cloud/v2/notes \
  --header 'Content-Type: application/json' \
  --data '
{
  "focus": "<string>",
  "content": "<string>",
  "type": "<string>",
  "title": "<string>",
  "date": "<string>"
}
'

import requests

url = "https://api.opennous.cloud/v2/notes"

payload = {
    "focus": "<string>",
    "content": "<string>",
    "type": "<string>",
    "title": "<string>",
    "date": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    focus: '<string>',
    content: '<string>',
    type: '<string>',
    title: '<string>',
    date: '<string>'
  })
};

fetch('https://api.opennous.cloud/v2/notes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.opennous.cloud/v2/notes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'focus' => '<string>',
    'content' => '<string>',
    'type' => '<string>',
    'title' => '<string>',
    'date' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.opennous.cloud/v2/notes"

	payload := strings.NewReader("{\n  \"focus\": \"<string>\",\n  \"content\": \"<string>\",\n  \"type\": \"<string>\",\n  \"title\": \"<string>\",\n  \"date\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.opennous.cloud/v2/notes")
  .header("Content-Type", "application/json")
  .body("{\n  \"focus\": \"<string>\",\n  \"content\": \"<string>\",\n  \"type\": \"<string>\",\n  \"title\": \"<string>\",\n  \"date\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.opennous.cloud/v2/notes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"focus\": \"<string>\",\n  \"content\": \"<string>\",\n  \"type\": \"<string>\",\n  \"title\": \"<string>\",\n  \"date\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

POST

notes

Save a Note

curl --request POST \
  --url https://api.opennous.cloud/v2/notes \
  --header 'Content-Type: application/json' \
  --data '
{
  "focus": "<string>",
  "content": "<string>",
  "type": "<string>",
  "title": "<string>",
  "date": "<string>"
}
'

import requests

url = "https://api.opennous.cloud/v2/notes"

payload = {
    "focus": "<string>",
    "content": "<string>",
    "type": "<string>",
    "title": "<string>",
    "date": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    focus: '<string>',
    content: '<string>',
    type: '<string>',
    title: '<string>',
    date: '<string>'
  })
};

fetch('https://api.opennous.cloud/v2/notes', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.opennous.cloud/v2/notes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'focus' => '<string>',
    'content' => '<string>',
    'type' => '<string>',
    'title' => '<string>',
    'date' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.opennous.cloud/v2/notes"

	payload := strings.NewReader("{\n  \"focus\": \"<string>\",\n  \"content\": \"<string>\",\n  \"type\": \"<string>\",\n  \"title\": \"<string>\",\n  \"date\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.opennous.cloud/v2/notes")
  .header("Content-Type", "application/json")
  .body("{\n  \"focus\": \"<string>\",\n  \"content\": \"<string>\",\n  \"type\": \"<string>\",\n  \"title\": \"<string>\",\n  \"date\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.opennous.cloud/v2/notes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"focus\": \"<string>\",\n  \"content\": \"<string>\",\n  \"type\": \"<string>\",\n  \"title\": \"<string>\",\n  \"date\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

Saves a long-form artifact onto a person or company so it stays on their record. This is for documents you keep on a contact — a meeting brief, a transcript, pre-meeting prep, research, or a plain note — not for logging that an interaction happened. For “an email was sent / a meeting happened”, use POST /v2/observations. Notes are append-only and dated, so a contact accumulates a record across meetings. Retrieve the relevant passage later with POST /v2/notes/search.

Request

curl -X POST https://api.opennous.cloud/v2/notes \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "focus": "sarah@acme.com",
    "type": "meeting_brief",
    "title": "Pre-meeting brief — renewal",
    "date": "2026-06-01",
    "content": "Sarah is evaluating for Q3. Budget waiting on close. Proposal at $12k/yr — expect a discount ask. Maria (CFO) is the economic buyer."
  }'

Body

string

required

Entity UUID, email, domain, or LinkedIn URL. Not a bare name — writes need a precise identifier so the entity can be created if it doesn’t exist yet.

string

required

The full note or document text — a short note or a complete brief/transcript. Kept whole for agents to read.

string

default:"note"

One of note, meeting_brief, transcript, meeting_notes, pre_meeting, research.

string

A short name, e.g. Pre-meeting brief — renewal or Transcript — Jun 1. Shown in the UI.

string

The relevant date (e.g. the meeting date), ISO or plain. Defaults to now.

Response

201 Created

{
  "note": {
    "id": "9f31c0a2-...",
    "metadata": {
      "doc_type": "meeting_brief",
      "title": "Pre-meeting brief — renewal",
      "date": "2026-06-01"
    }
  },
  "entity_id": "a1b2c3d4-...",
  "doc_type": "meeting_brief"
}

Notes vs observations

Path	What it writes	When to use
`POST /v2/notes`	A document kept on the contact (brief, transcript, note)	You produced something durable worth keeping for next time
`POST /v2/observations`	An immutable event/state; Nous derives the claim	An interaction happened, or a fact changed

After a meeting, use both: record the meeting via /v2/observations, keep the notes via /v2/notes.

Errors

Status	Error	What to do
400	`focus_and_content_required`	`focus` and a non-empty `content` are both required
400	`invalid_focus`	Provide an entity id, email, LinkedIn URL, or domain — not a bare name
401	`unauthorized`	API key missing or invalid

GTM Profile Search Notes

Overview

Account Context

Observations

People

Leads

Search

Workspace

Notes

Triggers

Save a Note

Request

Body

Response

Notes vs observations

Errors

​Request

​Body

​Response

​Notes vs observations

​Errors

Request

Body

Response

Notes vs observations

Errors