Create a note
curl --request POST \
--url https://api.vegaminds.com/v1/notes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "Annual review follow-up",
"body": "Discussed the college savings plan for their daughter.\n\n- Increase the monthly contribution in January\n- Review the beneficiary designations",
"contact_ids": [
"1f128fef-f499-4c88-a53e-75f235ccb65a"
],
"household_ids": [
"46852331-f25c-4fcc-9d16-2162c96be9ad"
]
}
'import requests
url = "https://api.vegaminds.com/v1/notes"
payload = {
"title": "Annual review follow-up",
"body": "Discussed the college savings plan for their daughter.
- Increase the monthly contribution in January
- Review the beneficiary designations",
"contact_ids": ["1f128fef-f499-4c88-a53e-75f235ccb65a"],
"household_ids": ["46852331-f25c-4fcc-9d16-2162c96be9ad"]
}
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({
title: 'Annual review follow-up',
body: JSON.stringify('Discussed the college savings plan for their daughter.\n\n- Increase the monthly contribution in January\n- Review the beneficiary designations'),
contact_ids: ['1f128fef-f499-4c88-a53e-75f235ccb65a'],
household_ids: ['46852331-f25c-4fcc-9d16-2162c96be9ad']
})
};
fetch('https://api.vegaminds.com/v1/notes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"is_external": false,
"id": "9d9c0b33-7e53-4ef6-a730-f034d38cb137",
"title": "Annual review follow-up",
"tags": [],
"body": "Discussed the college savings plan for their daughter.\n\n- Increase the monthly contribution in January\n- Review the beneficiary designations",
"contacts": [
{
"id": "1f128fef-f499-4c88-a53e-75f235ccb65a",
"name": "Jordan Ellis"
}
],
"households": [
{
"id": "46852331-f25c-4fcc-9d16-2162c96be9ad",
"name": "Ellis family"
}
],
"created_on": "2026-11-04T15:20:03Z",
"updated_on": "2026-11-04T15:20:03Z"
}{
"error": {
"code": "invalid_request",
"message": "The request body is invalid.",
"fields": {
"email_addresses[0].address": "Must be an email address."
}
},
"request_id": "3f6c1e9a-2b7d-4c58-9e41-8a0d5b7f2c16"
}{
"error": {
"code": "invalid_token",
"message": "The access token is invalid, expired or revoked."
},
"request_id": "3f6c1e9a-2b7d-4c58-9e41-8a0d5b7f2c16"
}{
"error": {
"code": "insufficient_scope",
"message": "This request needs the contacts:write scope, which the user did not grant. Connect the user again, asking for it."
},
"request_id": "3f6c1e9a-2b7d-4c58-9e41-8a0d5b7f2c16"
}{
"error": {
"code": "rate_limited",
"message": "Too many requests. Wait the number of seconds in the Retry-After header, then try again."
}
}{
"error": {
"code": "internal_error",
"message": "Something went wrong on our side. Try again later, and contact Vega support with the request id if it keeps happening."
},
"request_id": "3f6c1e9a-2b7d-4c58-9e41-8a0d5b7f2c16"
}Notes
Create a note
Creates a note owned by the connected user, linked to the given contacts and households. Links are set here only; they are changed later in Vega.
POST
/
notes
Create a note
curl --request POST \
--url https://api.vegaminds.com/v1/notes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "Annual review follow-up",
"body": "Discussed the college savings plan for their daughter.\n\n- Increase the monthly contribution in January\n- Review the beneficiary designations",
"contact_ids": [
"1f128fef-f499-4c88-a53e-75f235ccb65a"
],
"household_ids": [
"46852331-f25c-4fcc-9d16-2162c96be9ad"
]
}
'import requests
url = "https://api.vegaminds.com/v1/notes"
payload = {
"title": "Annual review follow-up",
"body": "Discussed the college savings plan for their daughter.
- Increase the monthly contribution in January
- Review the beneficiary designations",
"contact_ids": ["1f128fef-f499-4c88-a53e-75f235ccb65a"],
"household_ids": ["46852331-f25c-4fcc-9d16-2162c96be9ad"]
}
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({
title: 'Annual review follow-up',
body: JSON.stringify('Discussed the college savings plan for their daughter.\n\n- Increase the monthly contribution in January\n- Review the beneficiary designations'),
contact_ids: ['1f128fef-f499-4c88-a53e-75f235ccb65a'],
household_ids: ['46852331-f25c-4fcc-9d16-2162c96be9ad']
})
};
fetch('https://api.vegaminds.com/v1/notes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"is_external": false,
"id": "9d9c0b33-7e53-4ef6-a730-f034d38cb137",
"title": "Annual review follow-up",
"tags": [],
"body": "Discussed the college savings plan for their daughter.\n\n- Increase the monthly contribution in January\n- Review the beneficiary designations",
"contacts": [
{
"id": "1f128fef-f499-4c88-a53e-75f235ccb65a",
"name": "Jordan Ellis"
}
],
"households": [
{
"id": "46852331-f25c-4fcc-9d16-2162c96be9ad",
"name": "Ellis family"
}
],
"created_on": "2026-11-04T15:20:03Z",
"updated_on": "2026-11-04T15:20:03Z"
}{
"error": {
"code": "invalid_request",
"message": "The request body is invalid.",
"fields": {
"email_addresses[0].address": "Must be an email address."
}
},
"request_id": "3f6c1e9a-2b7d-4c58-9e41-8a0d5b7f2c16"
}{
"error": {
"code": "invalid_token",
"message": "The access token is invalid, expired or revoked."
},
"request_id": "3f6c1e9a-2b7d-4c58-9e41-8a0d5b7f2c16"
}{
"error": {
"code": "insufficient_scope",
"message": "This request needs the contacts:write scope, which the user did not grant. Connect the user again, asking for it."
},
"request_id": "3f6c1e9a-2b7d-4c58-9e41-8a0d5b7f2c16"
}{
"error": {
"code": "rate_limited",
"message": "Too many requests. Wait the number of seconds in the Retry-After header, then try again."
}
}{
"error": {
"code": "internal_error",
"message": "Something went wrong on our side. Try again later, and contact Vega support with the request id if it keeps happening."
},
"request_id": "3f6c1e9a-2b7d-4c58-9e41-8a0d5b7f2c16"
}Authorizations
Body
application/json
Response
The created note.
True when this record has an active integration link, including an export from Vega. This is current linkage, not historical origin, and is independent of linked contacts or households. Associated records cannot be patched or deleted through this API, except that a meeting may patch reviewed alone. No provider/account details are exposed.

