Create a Note
Attach a free-form note to a scheduled event for internal context, meeting prep, or post-call follow-up.
curl --request POST \
--url https://api.zeeg.me/v2/notes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"relation": "event",
"uuid": "zg-O69bac566950c6",
"note": "<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>"
}
'import requests
url = "https://api.zeeg.me/v2/notes"
payload = {
"relation": "event",
"uuid": "zg-O69bac566950c6",
"note": "<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
relation: 'event',
uuid: 'zg-O69bac566950c6',
note: '<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>'
})
};
fetch('https://api.zeeg.me/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.zeeg.me/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([
'relation' => 'event',
'uuid' => 'zg-O69bac566950c6',
'note' => '<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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.zeeg.me/v2/notes"
payload := strings.NewReader("{\n \"relation\": \"event\",\n \"uuid\": \"zg-O69bac566950c6\",\n \"note\": \"<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.zeeg.me/v2/notes")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"relation\": \"event\",\n \"uuid\": \"zg-O69bac566950c6\",\n \"note\": \"<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zeeg.me/v2/notes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"relation\": \"event\",\n \"uuid\": \"zg-O69bac566950c6\",\n \"note\": \"<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"status": 201,
"data": {
"id": 42,
"uuid": "vIgm8IvNzD",
"note": "<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>",
"eventUuid": "zg-O69bac566950c6",
"crmRecords": [],
"event": null,
"creator": {
"firstName": "Lena",
"lastName": "Meier",
"slug": "lena-meier",
"avatar": null
},
"updatedAt": "2026-04-15 10:32:00",
"createdAt": "2026-04-15 10:32:00"
}
}{
"message": "Unauthenticated."
}{
"error": {
"type": "insufficient_scope",
"message": "Your token is missing the required scope: notes:write.",
"error_id": "b3077456-6363-4854-b4b9-7671ff51384a",
"required_scopes": [
"notes:write"
]
}
}{
"error": "no record or event found"
}{
"success": false,
"message": "Event not found",
"status": 500
}Authorizations
Body
The type of resource to attach the note to.
event The UUID of the event to attach the note to.
The note content. Supports basic HTML formatting (e.g. , ,
).
500"Also basic <b>HTML</b> tags are supported."
Response
Created
Hide child attributes
Hide child attributes
Numeric note ID
Short alphanumeric identifier
"2lZb5IpExv"
Note content (supports basic HTML)
Zeeg event identifier
"zg-R69bc06d3ac712"
CRM records linked to this note. Empty array when none are linked.
Hide child attributes
Hide child attributes
"people"
Relative CRM path to the linked record.
"/crm/people/b75befd3-c539-4e0f-9d0e-8a0b59c4e725"
Populated on Get and Update. Null on List and Create — only eventUuid is guaranteed on those endpoints.
Hide child attributes
Hide child attributes
Zeeg event identifier
"zg-R69bc06d3ac712"
Last-update timestamp in the caller's timezone, format Y-m-d H:i:s.
"2026-04-15 10:32:00"
Creation timestamp in the caller's timezone, format Y-m-d H:i:s.
"2026-04-15 10:32:00"
curl --request POST \
--url https://api.zeeg.me/v2/notes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"relation": "event",
"uuid": "zg-O69bac566950c6",
"note": "<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>"
}
'import requests
url = "https://api.zeeg.me/v2/notes"
payload = {
"relation": "event",
"uuid": "zg-O69bac566950c6",
"note": "<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
relation: 'event',
uuid: 'zg-O69bac566950c6',
note: '<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>'
})
};
fetch('https://api.zeeg.me/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.zeeg.me/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([
'relation' => 'event',
'uuid' => 'zg-O69bac566950c6',
'note' => '<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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.zeeg.me/v2/notes"
payload := strings.NewReader("{\n \"relation\": \"event\",\n \"uuid\": \"zg-O69bac566950c6\",\n \"note\": \"<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.zeeg.me/v2/notes")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"relation\": \"event\",\n \"uuid\": \"zg-O69bac566950c6\",\n \"note\": \"<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zeeg.me/v2/notes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"relation\": \"event\",\n \"uuid\": \"zg-O69bac566950c6\",\n \"note\": \"<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"status": 201,
"data": {
"id": 42,
"uuid": "vIgm8IvNzD",
"note": "<p>Sophie prefers afternoon slots. Follow up about enterprise plan.</p>",
"eventUuid": "zg-O69bac566950c6",
"crmRecords": [],
"event": null,
"creator": {
"firstName": "Lena",
"lastName": "Meier",
"slug": "lena-meier",
"avatar": null
},
"updatedAt": "2026-04-15 10:32:00",
"createdAt": "2026-04-15 10:32:00"
}
}{
"message": "Unauthenticated."
}{
"error": {
"type": "insufficient_scope",
"message": "Your token is missing the required scope: notes:write.",
"error_id": "b3077456-6363-4854-b4b9-7671ff51384a",
"required_scopes": [
"notes:write"
]
}
}{
"error": "no record or event found"
}{
"success": false,
"message": "Event not found",
"status": 500
}