List notifications
The calling user’s notification feed for this account, 15 to a page, newest activity first.
By default this returns only notifications that are unread and not snoozed — pass includes[]=read and includes[]=snoozed to widen it. That also changes what unread_count means: without read, every result is unread and unread_count equals count; with it, unread_count is the unread subset.
The envelope is nested one level deeper than the rest of the API: payload and meta live under data.
GET
/
api
/
v1
/
accounts
/
{account_id}
/
notifications
List notifications
curl --request GET \
--url https://app.tied.com/api/v1/accounts/{account_id}/notifications \
--header 'api_access_token: <api-key>'import requests
url = "https://app.tied.com/api/v1/accounts/{account_id}/notifications"
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}/notifications', 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}/notifications")
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}/notifications"
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))
}{
"data": {
"meta": {
"unread_count": 2,
"count": 2,
"current_page": 1
},
"payload": [
{
"id": 1,
"notification_type": "conversation_assignment",
"push_message_title": "A conversation (#190) has been assigned to you",
"push_message_body": "Jen Park: Need help choosing between two plans.",
"primary_actor_type": "Conversation",
"primary_actor_id": 190,
"primary_actor": {
"additional_attributes": {},
"can_reply": true,
"channel": "Channel::WebWidget",
"contact_inbox": {
"id": 159,
"contact_id": 163,
"inbox_id": 4,
"source_id": "EXAMPLE_SOURCE_ID",
"created_at": "2026-09-21T03:17:03.949Z",
"updated_at": "2026-09-21T03:17:03.949Z",
"hmac_verified": false,
"pubsub_token": "EXAMPLE_PUBSUB_TOKEN"
},
"id": 190,
"inbox_id": 4,
"messages": [
{
"id": 639,
"content": "Need help choosing between two plans.",
"account_id": 1,
"inbox_id": 4,
"conversation_id": 190,
"message_type": 0,
"created_at": 1789948863,
"updated_at": "2026-09-21T00:01:03.954Z",
"private": false,
"status": "sent",
"source_id": null,
"content_type": "text",
"content_attributes": {},
"sender_type": "Contact",
"sender_id": 163,
"external_source_ids": {},
"additional_attributes": {},
"processed_message_content": null,
"sentiment": {},
"source_identity_uniqueness_exempt_at": null,
"actor": null,
"conversation": {
"assignee_id": null,
"unread_count": 0,
"last_activity_at": 1789948623,
"contact_inbox": {
"source_id": "EXAMPLE_SOURCE_ID"
}
},
"sender": {
"additional_attributes": {},
"custom_attributes": {},
"email": null,
"id": 163,
"identifier": null,
"name": "Jen Park",
"phone_number": null,
"thumbnail": "",
"thumbnail_background_color": null,
"domain_logo_avatar": false,
"customer_verified": false,
"blocked": false,
"type": "contact"
}
}
],
"labels": [],
"meta": {
"sender": {
"additional_attributes": {},
"custom_attributes": {},
"email": null,
"id": 163,
"identifier": null,
"name": "Jen Park",
"phone_number": null,
"thumbnail": "",
"thumbnail_background_color": null,
"domain_logo_avatar": false,
"customer_verified": false,
"blocked": false,
"type": "contact"
},
"assignee": null,
"team": null,
"hmac_verified": false
},
"status": "open",
"custom_attributes": {},
"snoozed_until": null,
"unread_count": 0,
"first_reply_created_at": null,
"priority": null,
"waiting_since": 0,
"agent_last_seen_at": 1789948923,
"contact_last_seen_at": 0,
"last_activity_at": 1789948623,
"timestamp": 1789948623,
"created_at": 1789960623,
"updated_at": 1789960624.0422678
},
"read_at": null,
"secondary_actor": null,
"user": {
"id": 1,
"name": "Alex Rivera",
"available_name": "Alex Rivera",
"avatar_url": "",
"type": "user",
"availability_status": "offline",
"thumbnail": "/dashboard/images/default-contact-avatars/031.svg",
"illustration_avatar": true,
"accent_color": null
},
"created_at": 1789960145,
"last_activity_at": 1789960145,
"snoozed_until": null,
"meta": {}
},
{
"id": 2,
"notification_type": "assigned_conversation_new_message",
"push_message_title": "A new message is created in conversation (#189)",
"push_message_body": ": No content",
"primary_actor_type": "Conversation",
"primary_actor_id": 189,
"primary_actor": {
"additional_attributes": {},
"can_reply": true,
"channel": "Channel::WebWidget",
"contact_inbox": {
"id": 158,
"contact_id": 162,
"inbox_id": 4,
"source_id": "EXAMPLE_SOURCE_ID",
"created_at": "2026-09-21T03:17:03.935Z",
"updated_at": "2026-09-21T03:17:03.935Z",
"hmac_verified": false,
"pubsub_token": "EXAMPLE_PUBSUB_TOKEN"
},
"id": 189,
"inbox_id": 4,
"messages": [
{
"id": 636,
"content": "Reading your docs right now.",
"account_id": 1,
"inbox_id": 4,
"conversation_id": 189,
"message_type": 0,
"created_at": 1789950063,
"updated_at": "2026-09-21T00:21:03.943Z",
"private": false,
"status": "sent",
"source_id": null,
"content_type": "text",
"content_attributes": {},
"sender_type": "Contact",
"sender_id": 162,
"external_source_ids": {},
"additional_attributes": {},
"processed_message_content": null,
"sentiment": {},
"source_identity_uniqueness_exempt_at": null,
"actor": null,
"conversation": {
"assignee_id": null,
"unread_count": 0,
"last_activity_at": 1789949823,
"contact_inbox": {
"source_id": "EXAMPLE_SOURCE_ID"
}
},
"sender": {
"additional_attributes": {},
"custom_attributes": {},
"email": null,
"id": 162,
"identifier": null,
"name": "Alex Rivera",
"phone_number": null,
"thumbnail": "",
"thumbnail_background_color": null,
"domain_logo_avatar": false,
"customer_verified": false,
"blocked": false,
"type": "contact"
}
}
],
"labels": [],
"meta": {
"sender": {
"additional_attributes": {},
"custom_attributes": {},
"email": null,
"id": 162,
"identifier": null,
"name": "Alex Rivera",
"phone_number": null,
"thumbnail": "",
"thumbnail_background_color": null,
"domain_logo_avatar": false,
"customer_verified": false,
"blocked": false,
"type": "contact"
},
"assignee": null,
"team": null,
"hmac_verified": false
},
"status": "open",
"custom_attributes": {},
"snoozed_until": null,
"unread_count": 0,
"first_reply_created_at": null,
"priority": null,
"waiting_since": 0,
"agent_last_seen_at": 1789950123,
"contact_last_seen_at": 0,
"last_activity_at": 1789949823,
"timestamp": 1789949823,
"created_at": 1789960623,
"updated_at": 1789960624.037724
},
"read_at": null,
"secondary_actor": null,
"user": {
"id": 1,
"name": "Alex Rivera",
"available_name": "Alex Rivera",
"avatar_url": "",
"type": "user",
"availability_status": "offline",
"thumbnail": "/dashboard/images/default-contact-avatars/031.svg",
"illustration_avatar": true,
"accent_color": null
},
"created_at": 1789958165,
"last_activity_at": 1789958165,
"snoozed_until": null,
"meta": {}
}
]
}
}{
"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
Query Parameters
Widen the feed. Repeat the parameter as includes[]=read&includes[]=snoozed.
Available options:
read, snoozed Only notifications with last_activity_at at or after this Unix epoch time.
Only notifications with last_activity_at at or before this Unix epoch time.
Order by last_activity_at. Defaults to desc.
Available options:
asc, desc The page parameter
Response
Success
The notification feed is nested one level deeper than the rest of the API — the payload and meta live under data.
The feed is nested under data, one level deeper than the rest of the API.
Show child attributes
Show child attributes
Was this page helpful?
⌘I
List notifications
curl --request GET \
--url https://app.tied.com/api/v1/accounts/{account_id}/notifications \
--header 'api_access_token: <api-key>'import requests
url = "https://app.tied.com/api/v1/accounts/{account_id}/notifications"
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}/notifications', 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}/notifications")
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}/notifications"
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))
}{
"data": {
"meta": {
"unread_count": 2,
"count": 2,
"current_page": 1
},
"payload": [
{
"id": 1,
"notification_type": "conversation_assignment",
"push_message_title": "A conversation (#190) has been assigned to you",
"push_message_body": "Jen Park: Need help choosing between two plans.",
"primary_actor_type": "Conversation",
"primary_actor_id": 190,
"primary_actor": {
"additional_attributes": {},
"can_reply": true,
"channel": "Channel::WebWidget",
"contact_inbox": {
"id": 159,
"contact_id": 163,
"inbox_id": 4,
"source_id": "EXAMPLE_SOURCE_ID",
"created_at": "2026-09-21T03:17:03.949Z",
"updated_at": "2026-09-21T03:17:03.949Z",
"hmac_verified": false,
"pubsub_token": "EXAMPLE_PUBSUB_TOKEN"
},
"id": 190,
"inbox_id": 4,
"messages": [
{
"id": 639,
"content": "Need help choosing between two plans.",
"account_id": 1,
"inbox_id": 4,
"conversation_id": 190,
"message_type": 0,
"created_at": 1789948863,
"updated_at": "2026-09-21T00:01:03.954Z",
"private": false,
"status": "sent",
"source_id": null,
"content_type": "text",
"content_attributes": {},
"sender_type": "Contact",
"sender_id": 163,
"external_source_ids": {},
"additional_attributes": {},
"processed_message_content": null,
"sentiment": {},
"source_identity_uniqueness_exempt_at": null,
"actor": null,
"conversation": {
"assignee_id": null,
"unread_count": 0,
"last_activity_at": 1789948623,
"contact_inbox": {
"source_id": "EXAMPLE_SOURCE_ID"
}
},
"sender": {
"additional_attributes": {},
"custom_attributes": {},
"email": null,
"id": 163,
"identifier": null,
"name": "Jen Park",
"phone_number": null,
"thumbnail": "",
"thumbnail_background_color": null,
"domain_logo_avatar": false,
"customer_verified": false,
"blocked": false,
"type": "contact"
}
}
],
"labels": [],
"meta": {
"sender": {
"additional_attributes": {},
"custom_attributes": {},
"email": null,
"id": 163,
"identifier": null,
"name": "Jen Park",
"phone_number": null,
"thumbnail": "",
"thumbnail_background_color": null,
"domain_logo_avatar": false,
"customer_verified": false,
"blocked": false,
"type": "contact"
},
"assignee": null,
"team": null,
"hmac_verified": false
},
"status": "open",
"custom_attributes": {},
"snoozed_until": null,
"unread_count": 0,
"first_reply_created_at": null,
"priority": null,
"waiting_since": 0,
"agent_last_seen_at": 1789948923,
"contact_last_seen_at": 0,
"last_activity_at": 1789948623,
"timestamp": 1789948623,
"created_at": 1789960623,
"updated_at": 1789960624.0422678
},
"read_at": null,
"secondary_actor": null,
"user": {
"id": 1,
"name": "Alex Rivera",
"available_name": "Alex Rivera",
"avatar_url": "",
"type": "user",
"availability_status": "offline",
"thumbnail": "/dashboard/images/default-contact-avatars/031.svg",
"illustration_avatar": true,
"accent_color": null
},
"created_at": 1789960145,
"last_activity_at": 1789960145,
"snoozed_until": null,
"meta": {}
},
{
"id": 2,
"notification_type": "assigned_conversation_new_message",
"push_message_title": "A new message is created in conversation (#189)",
"push_message_body": ": No content",
"primary_actor_type": "Conversation",
"primary_actor_id": 189,
"primary_actor": {
"additional_attributes": {},
"can_reply": true,
"channel": "Channel::WebWidget",
"contact_inbox": {
"id": 158,
"contact_id": 162,
"inbox_id": 4,
"source_id": "EXAMPLE_SOURCE_ID",
"created_at": "2026-09-21T03:17:03.935Z",
"updated_at": "2026-09-21T03:17:03.935Z",
"hmac_verified": false,
"pubsub_token": "EXAMPLE_PUBSUB_TOKEN"
},
"id": 189,
"inbox_id": 4,
"messages": [
{
"id": 636,
"content": "Reading your docs right now.",
"account_id": 1,
"inbox_id": 4,
"conversation_id": 189,
"message_type": 0,
"created_at": 1789950063,
"updated_at": "2026-09-21T00:21:03.943Z",
"private": false,
"status": "sent",
"source_id": null,
"content_type": "text",
"content_attributes": {},
"sender_type": "Contact",
"sender_id": 162,
"external_source_ids": {},
"additional_attributes": {},
"processed_message_content": null,
"sentiment": {},
"source_identity_uniqueness_exempt_at": null,
"actor": null,
"conversation": {
"assignee_id": null,
"unread_count": 0,
"last_activity_at": 1789949823,
"contact_inbox": {
"source_id": "EXAMPLE_SOURCE_ID"
}
},
"sender": {
"additional_attributes": {},
"custom_attributes": {},
"email": null,
"id": 162,
"identifier": null,
"name": "Alex Rivera",
"phone_number": null,
"thumbnail": "",
"thumbnail_background_color": null,
"domain_logo_avatar": false,
"customer_verified": false,
"blocked": false,
"type": "contact"
}
}
],
"labels": [],
"meta": {
"sender": {
"additional_attributes": {},
"custom_attributes": {},
"email": null,
"id": 162,
"identifier": null,
"name": "Alex Rivera",
"phone_number": null,
"thumbnail": "",
"thumbnail_background_color": null,
"domain_logo_avatar": false,
"customer_verified": false,
"blocked": false,
"type": "contact"
},
"assignee": null,
"team": null,
"hmac_verified": false
},
"status": "open",
"custom_attributes": {},
"snoozed_until": null,
"unread_count": 0,
"first_reply_created_at": null,
"priority": null,
"waiting_since": 0,
"agent_last_seen_at": 1789950123,
"contact_last_seen_at": 0,
"last_activity_at": 1789949823,
"timestamp": 1789949823,
"created_at": 1789960623,
"updated_at": 1789960624.037724
},
"read_at": null,
"secondary_actor": null,
"user": {
"id": 1,
"name": "Alex Rivera",
"available_name": "Alex Rivera",
"avatar_url": "",
"type": "user",
"availability_status": "offline",
"thumbnail": "/dashboard/images/default-contact-avatars/031.svg",
"illustration_avatar": true,
"accent_color": null
},
"created_at": 1789958165,
"last_activity_at": 1789958165,
"snoozed_until": null,
"meta": {}
}
]
}
}{
"error": "Resource could not be found"
}