The intercom API reference.
Home//
REST API Reference
/- Visitor
Activity Log
Paginated Response
Activity Log Metadata
Addressable List
Admins
Admin Priority Level
Admin Reply
Admin
App
Article Content
Articles
Article Statistics
Article Translated Content
Assign Conversation Request
Assign Conversation Request
Close Conversation Request
Collections
Company Attached Contacts
Company Attached Segments
Companies
Company Scroll
Contact Archived
Contact Attached Companies
Contact companies
Company Data
Contact Deleted
Contact List
Contact Location
Contact notes
Contact Reference
Contact Reply Base Object
Contact Reply
Email
Intercom User ID
Email
Intercom User ID
User ID
User ID
Segments
Social Profile
Contact Subscription Types
Contact Tags
Contact Unarchived
Conversation attachment files
Contacts
First contact reply
Conversation List
Conversation Part
Conversation part author
Conversation Parts
Conversation Rating
Conversation source
Conversation statistics
Conversation teammates
Convert Visitor Request Payload
Create Article Request Payload
Create Collection Request Payload
Create Contact Request Payload
Create Conversation Request Payload
Create Data Attribute Request
Create Data Event Request
Create Data Event Summaries Request
Create Data Export Request
Create Message Request Payload
Create Or Update Company Request Payload
Create or Update Tag Request Payload
Create Phone Switch Request Payload
Create Section Request Payload
Create Ticket Reply Request Payload
Create Ticket Request Payload
Create Ticket Type Attribute Request Payload
Create Ticket Type Request Payload
Cursor based pages
Custom Attributes
customer_request
Data Attribute List
Data Event List
Data Event Summary
Data Event Summary Item
Data Export CSV
Deleted Article Object
Deleted Collection Object
Deleted Company Object
Deleted Object
Deleted Section Object
detach_contact_from_conversation_request
Error
File
Group Content
Group Translated Content
intercom_version
Merge contact data
Multiple Filter Search Request
Create News Item Request
Paginated Response
Open Conversation Request
Pagination Object
Paginated Response
Part attachment
Phone Switch
redact_conversation_request
Reference
reply_conversation_request
Search data
Sections
Segment List
Single Filter Search Request
Applied SLA
Snooze Conversation Request
Social Profile
Pagination: Starting After
Subscription Types
Tag Company Request Payload
Tags
Tag Users Request Payload
Tags
Team List
Team Priority Level
Ticket Attributes
A Ticket Part representing a note
Ticket part author
Ticket Parts
Ticket Attributes
Ticket Type Attribute
Ticket Type Attributes
Ticket Types
Translation
Untag Company Request Payload
Update Article Request Payload
Update Collection Request Payload
Update Contact Request Payload
Update Conversation Request
Update Data Attribute Request
Update Section Request Payload
Update Ticket Request Payload
Update Ticket Type Attribute Request Payload
Update Ticket Type Request Payload
Update Visitor Request Payload
Visitor Deleted Object
Visitor
Intercom API (2.9)
Download OpenAPI description
Overview
URL
License
Languages
Servers
The production API server
https://api.intercom.io/
The european API server
https://api.eu.intercom.io/
The australian API server
https://api.au.intercom.io/
Update Visitor Request Payload
Update an existing visitor.
Any of:
Update an existing visitor.
A unique identified for the visitor which is given by Intercom.
Example: "8a88a590-e"
{ "id": "8a88a590-e", "user_id": "123", "name": "Christian Bale", "custom_attributes": { "paid_subscriber": true, "monthly_spend": 155.5, "team_mates": 9 } }
Visitor
Visitors are useful for representing anonymous people that have not yet been identified. They usually represent website visitors. Visitors are not visible in Intercom platform. The Visitors resource provides methods to fetch, update, convert and delete.
Automatically generated identifier for the Visitor.
Example: "8a88a590-e1c3-41e2-a502-e0649dbf721c"
{ "type": "visitor", "id": "530370b477ad7120001d", "user_id": "8a88a590-e1c3-41e2-a502-e0649dbf721c", "anonymous": false, "email": "jane.doe@example.com", "phone": "555-555-5555", "name": "Jane Doe", "pseudonym": "Red Duck from Dublin", "avatar": { "type": "avatar", "image_url": "https://example.com/avatar.png" }, "app_id": "hfi1bx4l", "companies": { "type": "company.list", "companies": [ … ] }, "location_data": { "type": "location_data", "city_name": "Dublin", "continent_code": "EU", "country_code": "IRL", "country_name": "Ireland", "postal_code": "D02 N960", "region_name": "Leinster", "timezone": "Europe/Dublin" }, "las_request_at": 1663597260, "created_at": 1663597223, "remote_created_at": 1663597223, "signed_up_at": 1663597223, "updated_at": 1663597260, "session_count": 1, "social_profiles": { "type": "social_profile.list", "social_profiles": [ … ] }, "owner_id": "5169261", "unsubscribed_from_emails": false, "marked_email_as_spam": false, "has_hard_bounced": false, "tags": { "type": "tag.list", "tags": [ … ] }, "segments": { "type": "segment.list", "segments": [ … ] }, "custom_attributes": { "property1": "string", "property2": "string" }, "referrer": "https://www.google.com/", "utm_campaign": "intercom-link", "utm_content": "banner", "utm_medium": "email", "utm_source": "Intercom", "utm_term": "messenger", "do_not_track": false }