Contact Conversations
Get conversations associated with that contact
GET
/
api
/
v1
/
accounts
/
{account_id}
/
contacts
/
{id}
/
conversations
Contact Conversations
curl --request GET \
--url https://app.tied.com/api/v1/accounts/{account_id}/contacts/{id}/conversations \
--header 'api_access_token: <api-key>'import requests
url = "https://app.tied.com/api/v1/accounts/{account_id}/contacts/{id}/conversations"
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/{id}/conversations', 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/{id}/conversations")
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/{id}/conversations"
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))
}{
"payload": [
{
"meta": {
"sender": {
"additional_attributes": {
"city": "San Francisco",
"country": "United States",
"location": "San Francisco, United States",
"description": "Head of Customer Experience at Northwind Supply. Migrating off a legacy helpdesk and launching on Apple Messages first. Prefers async follow-up.",
"company_name": "Northwind Supply Co.",
"country_code": "US",
"created_at_ip": "203.0.113.10",
"updated_at_ip": "203.0.113.10",
"avatar_url_hash": "0000000000000000000000000000000000000000",
"social_profiles": {
"github": "mokonkwo",
"tiktok": "northwindsupply",
"twitter": "mayabuildscx",
"facebook": "northwindsupply",
"linkedin": "maya-okonkwo",
"instagram": "northwind.supply"
},
"last_avatar_sync_at": "2026-09-21T02:21:05Z",
"social_telegram_user_name": "maya_okonkwo"
},
"availability_status": "offline",
"email": "maya@northwindsupply.com",
"id": 135,
"name": "Maya Okonkwo",
"phone_number": "+14155550198",
"blocked": false,
"identifier": "in_example",
"thumbnail": "https://app.tied.com/rails/active_storage/blobs/proxy/EXAMPLE/avatar.png",
"thumbnail_background_color": null,
"domain_logo_avatar": false,
"customer_verified": true,
"custom_attributes": {
"plan_tier": "Premium",
"lead_source": "Apple Messages — pricing page",
"profile_url": "https://tied.com/customers/northwind-supply",
"customer_since": "2024-03-15",
"lifetime_value": "48500",
"loyalty_discount": "12",
"newsletter_opt_in": true,
"satisfaction_score": "92"
},
"last_activity_at": 1789957263,
"created_at": 1789957262
},
"channel": "Channel::Amb",
"assignee": {
"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
},
"hmac_verified": false
},
"id": 155,
"messages": [
{
"id": 507,
"content": "Tuesday at 11 works — see you then!",
"account_id": 1,
"inbox_id": 1,
"conversation_id": 155,
"message_type": 0,
"created_at": 1789957083,
"updated_at": "2026-09-21T02:18:03.023Z",
"private": false,
"status": "sent",
"source_id": null,
"content_type": "text",
"content_attributes": {},
"sender_type": "Contact",
"sender_id": 135,
"external_source_ids": {},
"additional_attributes": {},
"processed_message_content": null,
"sentiment": {},
"source_identity_uniqueness_exempt_at": null,
"actor": null,
"conversation": {
"assignee_id": 1,
"unread_count": 0,
"last_activity_at": 1789957263,
"contact_inbox": {
"source_id": "sr_example"
}
},
"sender": {
"additional_attributes": {
"city": "San Francisco",
"country": "United States",
"location": "San Francisco, United States",
"description": "Head of Customer Experience at Northwind Supply. Migrating off a legacy helpdesk and launching on Apple Messages first. Prefers async follow-up.",
"company_name": "Northwind Supply Co.",
"country_code": "US",
"created_at_ip": "203.0.113.10",
"updated_at_ip": "203.0.113.10",
"avatar_url_hash": "0000000000000000000000000000000000000000",
"social_profiles": {
"github": "mokonkwo",
"tiktok": "northwindsupply",
"twitter": "mayabuildscx",
"facebook": "northwindsupply",
"linkedin": "maya-okonkwo",
"instagram": "northwind.supply"
},
"last_avatar_sync_at": "2026-09-21T02:21:05Z",
"social_telegram_user_name": "maya_okonkwo"
},
"custom_attributes": {
"plan_tier": "Premium",
"lead_source": "Apple Messages — pricing page",
"profile_url": "https://tied.com/customers/northwind-supply",
"customer_since": "2024-03-15",
"lifetime_value": "48500",
"loyalty_discount": "12",
"newsletter_opt_in": true,
"satisfaction_score": "92"
},
"email": "maya@northwindsupply.com",
"id": 135,
"identifier": "in_example",
"name": "Maya Okonkwo",
"phone_number": "+14155550198",
"thumbnail": "https://app.tied.com/rails/active_storage/blobs/proxy/EXAMPLE/avatar.png",
"thumbnail_background_color": null,
"domain_logo_avatar": false,
"customer_verified": true,
"blocked": false,
"type": "contact"
}
}
],
"account_id": 1,
"uuid": "00000000-0000-4000-8000-000000000000",
"additional_attributes": {
"browser": {
"device_name": "iPhone",
"browser_name": "Safari",
"platform_name": "iOS",
"browser_version": "18.4",
"platform_version": "18.4"
},
"referer": "https://tied.com/pricing",
"initiated_at": {
"timestamp": "2026-09-21 02:21:02 UTC"
},
"browser_language": "en",
"spinoco_instance_id": "demo-instance-8"
},
"agent_last_seen_at": 1789957143,
"assignee_last_seen_at": 0,
"can_reply": true,
"contact_last_seen_at": 0,
"custom_attributes": {
"setup_stage": "Apple Messages connected — flows next",
"migrating_from": "Legacy helpdesk — 40k tickets to import",
"primary_channel": "Apple Messages",
"onboarding_status": "Confirmed",
"onboarding_call_at": "2026-09-22T11:00:00Z"
},
"inbox_id": 1,
"labels": [
"needs-reply",
"scheduling"
],
"muted": false,
"snoozed_until": null,
"status": "open",
"created_at": 1789957262,
"updated_at": 1789957265.1759071,
"timestamp": 1789957263,
"first_reply_created_at": 0,
"unread_count": 0,
"last_non_activity_message": {
"id": 507,
"content": "Tuesday at 11 works — see you then!",
"account_id": 1,
"inbox_id": 1,
"conversation_id": 155,
"message_type": 0,
"created_at": 1789957083,
"updated_at": "2026-09-21T02:18:03.023Z",
"private": false,
"status": "sent",
"source_id": null,
"content_type": "text",
"content_attributes": {},
"sender_type": "Contact",
"sender_id": 135,
"external_source_ids": {},
"additional_attributes": {},
"processed_message_content": null,
"sentiment": {},
"source_identity_uniqueness_exempt_at": null,
"actor": null,
"conversation": {
"assignee_id": 1,
"unread_count": 0,
"last_activity_at": 1789957263,
"contact_inbox": {
"source_id": "sr_example"
}
},
"sender": {
"additional_attributes": {
"city": "San Francisco",
"country": "United States",
"location": "San Francisco, United States",
"description": "Head of Customer Experience at Northwind Supply. Migrating off a legacy helpdesk and launching on Apple Messages first. Prefers async follow-up.",
"company_name": "Northwind Supply Co.",
"country_code": "US",
"created_at_ip": "203.0.113.10",
"updated_at_ip": "203.0.113.10",
"avatar_url_hash": "0000000000000000000000000000000000000000",
"social_profiles": {
"github": "mokonkwo",
"tiktok": "northwindsupply",
"twitter": "mayabuildscx",
"facebook": "northwindsupply",
"linkedin": "maya-okonkwo",
"instagram": "northwind.supply"
},
"last_avatar_sync_at": "2026-09-21T02:21:05Z",
"social_telegram_user_name": "maya_okonkwo"
},
"custom_attributes": {
"plan_tier": "Premium",
"lead_source": "Apple Messages — pricing page",
"profile_url": "https://tied.com/customers/northwind-supply",
"customer_since": "2024-03-15",
"lifetime_value": "48500",
"loyalty_discount": "12",
"newsletter_opt_in": true,
"satisfaction_score": "92"
},
"email": "maya@northwindsupply.com",
"id": 135,
"identifier": "in_example",
"name": "Maya Okonkwo",
"phone_number": "+14155550198",
"thumbnail": "https://app.tied.com/rails/active_storage/blobs/proxy/EXAMPLE/avatar.png",
"thumbnail_background_color": null,
"domain_logo_avatar": false,
"customer_verified": true,
"blocked": false,
"type": "contact"
}
},
"last_activity_at": 1789957263,
"priority": "high",
"waiting_since": 0,
"sla_policy_id": null
}
]
}{
"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
ID of the contact
Response
Success
List of conversations for the contact
Show child attributes
Show child attributes
Was this page helpful?
⌘I
Contact Conversations
curl --request GET \
--url https://app.tied.com/api/v1/accounts/{account_id}/contacts/{id}/conversations \
--header 'api_access_token: <api-key>'import requests
url = "https://app.tied.com/api/v1/accounts/{account_id}/contacts/{id}/conversations"
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/{id}/conversations', 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/{id}/conversations")
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/{id}/conversations"
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))
}{
"payload": [
{
"meta": {
"sender": {
"additional_attributes": {
"city": "San Francisco",
"country": "United States",
"location": "San Francisco, United States",
"description": "Head of Customer Experience at Northwind Supply. Migrating off a legacy helpdesk and launching on Apple Messages first. Prefers async follow-up.",
"company_name": "Northwind Supply Co.",
"country_code": "US",
"created_at_ip": "203.0.113.10",
"updated_at_ip": "203.0.113.10",
"avatar_url_hash": "0000000000000000000000000000000000000000",
"social_profiles": {
"github": "mokonkwo",
"tiktok": "northwindsupply",
"twitter": "mayabuildscx",
"facebook": "northwindsupply",
"linkedin": "maya-okonkwo",
"instagram": "northwind.supply"
},
"last_avatar_sync_at": "2026-09-21T02:21:05Z",
"social_telegram_user_name": "maya_okonkwo"
},
"availability_status": "offline",
"email": "maya@northwindsupply.com",
"id": 135,
"name": "Maya Okonkwo",
"phone_number": "+14155550198",
"blocked": false,
"identifier": "in_example",
"thumbnail": "https://app.tied.com/rails/active_storage/blobs/proxy/EXAMPLE/avatar.png",
"thumbnail_background_color": null,
"domain_logo_avatar": false,
"customer_verified": true,
"custom_attributes": {
"plan_tier": "Premium",
"lead_source": "Apple Messages — pricing page",
"profile_url": "https://tied.com/customers/northwind-supply",
"customer_since": "2024-03-15",
"lifetime_value": "48500",
"loyalty_discount": "12",
"newsletter_opt_in": true,
"satisfaction_score": "92"
},
"last_activity_at": 1789957263,
"created_at": 1789957262
},
"channel": "Channel::Amb",
"assignee": {
"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
},
"hmac_verified": false
},
"id": 155,
"messages": [
{
"id": 507,
"content": "Tuesday at 11 works — see you then!",
"account_id": 1,
"inbox_id": 1,
"conversation_id": 155,
"message_type": 0,
"created_at": 1789957083,
"updated_at": "2026-09-21T02:18:03.023Z",
"private": false,
"status": "sent",
"source_id": null,
"content_type": "text",
"content_attributes": {},
"sender_type": "Contact",
"sender_id": 135,
"external_source_ids": {},
"additional_attributes": {},
"processed_message_content": null,
"sentiment": {},
"source_identity_uniqueness_exempt_at": null,
"actor": null,
"conversation": {
"assignee_id": 1,
"unread_count": 0,
"last_activity_at": 1789957263,
"contact_inbox": {
"source_id": "sr_example"
}
},
"sender": {
"additional_attributes": {
"city": "San Francisco",
"country": "United States",
"location": "San Francisco, United States",
"description": "Head of Customer Experience at Northwind Supply. Migrating off a legacy helpdesk and launching on Apple Messages first. Prefers async follow-up.",
"company_name": "Northwind Supply Co.",
"country_code": "US",
"created_at_ip": "203.0.113.10",
"updated_at_ip": "203.0.113.10",
"avatar_url_hash": "0000000000000000000000000000000000000000",
"social_profiles": {
"github": "mokonkwo",
"tiktok": "northwindsupply",
"twitter": "mayabuildscx",
"facebook": "northwindsupply",
"linkedin": "maya-okonkwo",
"instagram": "northwind.supply"
},
"last_avatar_sync_at": "2026-09-21T02:21:05Z",
"social_telegram_user_name": "maya_okonkwo"
},
"custom_attributes": {
"plan_tier": "Premium",
"lead_source": "Apple Messages — pricing page",
"profile_url": "https://tied.com/customers/northwind-supply",
"customer_since": "2024-03-15",
"lifetime_value": "48500",
"loyalty_discount": "12",
"newsletter_opt_in": true,
"satisfaction_score": "92"
},
"email": "maya@northwindsupply.com",
"id": 135,
"identifier": "in_example",
"name": "Maya Okonkwo",
"phone_number": "+14155550198",
"thumbnail": "https://app.tied.com/rails/active_storage/blobs/proxy/EXAMPLE/avatar.png",
"thumbnail_background_color": null,
"domain_logo_avatar": false,
"customer_verified": true,
"blocked": false,
"type": "contact"
}
}
],
"account_id": 1,
"uuid": "00000000-0000-4000-8000-000000000000",
"additional_attributes": {
"browser": {
"device_name": "iPhone",
"browser_name": "Safari",
"platform_name": "iOS",
"browser_version": "18.4",
"platform_version": "18.4"
},
"referer": "https://tied.com/pricing",
"initiated_at": {
"timestamp": "2026-09-21 02:21:02 UTC"
},
"browser_language": "en",
"spinoco_instance_id": "demo-instance-8"
},
"agent_last_seen_at": 1789957143,
"assignee_last_seen_at": 0,
"can_reply": true,
"contact_last_seen_at": 0,
"custom_attributes": {
"setup_stage": "Apple Messages connected — flows next",
"migrating_from": "Legacy helpdesk — 40k tickets to import",
"primary_channel": "Apple Messages",
"onboarding_status": "Confirmed",
"onboarding_call_at": "2026-09-22T11:00:00Z"
},
"inbox_id": 1,
"labels": [
"needs-reply",
"scheduling"
],
"muted": false,
"snoozed_until": null,
"status": "open",
"created_at": 1789957262,
"updated_at": 1789957265.1759071,
"timestamp": 1789957263,
"first_reply_created_at": 0,
"unread_count": 0,
"last_non_activity_message": {
"id": 507,
"content": "Tuesday at 11 works — see you then!",
"account_id": 1,
"inbox_id": 1,
"conversation_id": 155,
"message_type": 0,
"created_at": 1789957083,
"updated_at": "2026-09-21T02:18:03.023Z",
"private": false,
"status": "sent",
"source_id": null,
"content_type": "text",
"content_attributes": {},
"sender_type": "Contact",
"sender_id": 135,
"external_source_ids": {},
"additional_attributes": {},
"processed_message_content": null,
"sentiment": {},
"source_identity_uniqueness_exempt_at": null,
"actor": null,
"conversation": {
"assignee_id": 1,
"unread_count": 0,
"last_activity_at": 1789957263,
"contact_inbox": {
"source_id": "sr_example"
}
},
"sender": {
"additional_attributes": {
"city": "San Francisco",
"country": "United States",
"location": "San Francisco, United States",
"description": "Head of Customer Experience at Northwind Supply. Migrating off a legacy helpdesk and launching on Apple Messages first. Prefers async follow-up.",
"company_name": "Northwind Supply Co.",
"country_code": "US",
"created_at_ip": "203.0.113.10",
"updated_at_ip": "203.0.113.10",
"avatar_url_hash": "0000000000000000000000000000000000000000",
"social_profiles": {
"github": "mokonkwo",
"tiktok": "northwindsupply",
"twitter": "mayabuildscx",
"facebook": "northwindsupply",
"linkedin": "maya-okonkwo",
"instagram": "northwind.supply"
},
"last_avatar_sync_at": "2026-09-21T02:21:05Z",
"social_telegram_user_name": "maya_okonkwo"
},
"custom_attributes": {
"plan_tier": "Premium",
"lead_source": "Apple Messages — pricing page",
"profile_url": "https://tied.com/customers/northwind-supply",
"customer_since": "2024-03-15",
"lifetime_value": "48500",
"loyalty_discount": "12",
"newsletter_opt_in": true,
"satisfaction_score": "92"
},
"email": "maya@northwindsupply.com",
"id": 135,
"identifier": "in_example",
"name": "Maya Okonkwo",
"phone_number": "+14155550198",
"thumbnail": "https://app.tied.com/rails/active_storage/blobs/proxy/EXAMPLE/avatar.png",
"thumbnail_background_color": null,
"domain_logo_avatar": false,
"customer_verified": true,
"blocked": false,
"type": "contact"
}
},
"last_activity_at": 1789957263,
"priority": "high",
"waiting_since": 0,
"sla_policy_id": null
}
]
}{
"error": "Resource could not be found"
}{
"error": "Resource could not be found"
}