List notes on a contact
Every note on the contact, newest first, each with the agent who wrote it. Notes are internal — a contact never sees them.
curl --request GET \
--url https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/notes \
--header 'api_access_token: <api-key>'import requests
url = "https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/notes"
headers = {"api_access_token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {api_access_token: '<api-key>'}};
fetch('https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/notes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/notes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["api_access_token"] = '<api-key>'
response = http.request(request)
puts response.read_bodypackage main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/notes"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api_access_token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}[
{
"id": 24,
"content": "Onboarding call booked for Tuesday 11 AM. Three extra seats paid for in thread. Plan comparison and connection guide both sent via Apple Messages rich features.",
"account_id": 1,
"contact_id": 156,
"user": {
"id": 1,
"account_id": 1,
"availability_status": "offline",
"auto_offline": true,
"confirmed": true,
"email": "you@example.com",
"provider": "email",
"available_name": "Alex Rivera",
"name": "Alex Rivera",
"role": "administrator",
"thumbnail": "/dashboard/images/default-contact-avatars/031.svg",
"avatar_url": "",
"illustration_avatar": true,
"accent_color": null,
"custom_role_id": null
},
"created_at": 1789960625,
"updated_at": 1789960625
},
{
"id": 23,
"content": "Submitted brand details and authorised the order-system integration. Migrating off a legacy helpdesk with roughly 40k historical tickets — import scoped, not scheduled.",
"account_id": 1,
"contact_id": 156,
"user": {
"id": 1,
"account_id": 1,
"availability_status": "offline",
"auto_offline": true,
"confirmed": true,
"email": "you@example.com",
"provider": "email",
"available_name": "Alex Rivera",
"name": "Alex Rivera",
"role": "administrator",
"thumbnail": "/dashboard/images/default-contact-avatars/031.svg",
"avatar_url": "",
"illustration_avatar": true,
"accent_color": null,
"custom_role_id": null
},
"created_at": 1789787825,
"updated_at": 1789787825
}
]{
"error": "Resource could not be found"
}{
"error": "Resource could not be found"
}Authorizations
This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.
Path Parameters
The numeric ID of the account
The numeric ID of the contact the note belongs to.
156
Response
Success
The numeric ID of the note.
The note body. Markdown is stored verbatim and rendered by the dashboard.
The account the note belongs to.
The contact the note is attached to.
Show child attributes
Show child attributes
Creation time as a Unix epoch in seconds.
Last update time as a Unix epoch in seconds.
Was this page helpful?
curl --request GET \
--url https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/notes \
--header 'api_access_token: <api-key>'import requests
url = "https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/notes"
headers = {"api_access_token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {api_access_token: '<api-key>'}};
fetch('https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/notes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));require 'uri'
require 'net/http'
url = URI("https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/notes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["api_access_token"] = '<api-key>'
response = http.request(request)
puts response.read_bodypackage main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.tied.com/api/v1/accounts/{account_id}/contacts/{contact_id}/notes"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api_access_token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}[
{
"id": 24,
"content": "Onboarding call booked for Tuesday 11 AM. Three extra seats paid for in thread. Plan comparison and connection guide both sent via Apple Messages rich features.",
"account_id": 1,
"contact_id": 156,
"user": {
"id": 1,
"account_id": 1,
"availability_status": "offline",
"auto_offline": true,
"confirmed": true,
"email": "you@example.com",
"provider": "email",
"available_name": "Alex Rivera",
"name": "Alex Rivera",
"role": "administrator",
"thumbnail": "/dashboard/images/default-contact-avatars/031.svg",
"avatar_url": "",
"illustration_avatar": true,
"accent_color": null,
"custom_role_id": null
},
"created_at": 1789960625,
"updated_at": 1789960625
},
{
"id": 23,
"content": "Submitted brand details and authorised the order-system integration. Migrating off a legacy helpdesk with roughly 40k historical tickets — import scoped, not scheduled.",
"account_id": 1,
"contact_id": 156,
"user": {
"id": 1,
"account_id": 1,
"availability_status": "offline",
"auto_offline": true,
"confirmed": true,
"email": "you@example.com",
"provider": "email",
"available_name": "Alex Rivera",
"name": "Alex Rivera",
"role": "administrator",
"thumbnail": "/dashboard/images/default-contact-avatars/031.svg",
"avatar_url": "",
"illustration_avatar": true,
"accent_color": null,
"custom_role_id": null
},
"created_at": 1789787825,
"updated_at": 1789787825
}
]{
"error": "Resource could not be found"
}{
"error": "Resource could not be found"
}