Skip to main content

​
Query

query {
  contactItem(
    apiKey: String!
    id: String!
  ): ContactItem
}

​
Parameters

​
apiKey
string
required
Your Tellscope API key
​
id
string
required
The unique identifier of the contact

​
Response

Returns a single ContactItem or null if not found.
​
id
string
Unique identifier
​
name
string
Full name of the contact
​
email
string
Email address
​
phone
string
Phone number
​
company
string
Company or organization name
​
title
string
Job title or role
​
location
string
Geographic location
​
tags
array
Tags assigned to this contact
​
totalFeedbacks
integer
Total number of feedback items from this contact
​
lastInteraction
datetime
Date of most recent interaction
​
createdAt
datetime
When the contact was added

​
Example

query {
  contactItem(
    apiKey: "tellscp_sk_YOUR_API_KEY"
    id: "cnt_abc123"
  ) {
    id
    name
    email
    phone
    company
    title
    location
    tags
    totalFeedbacks
    lastInteraction
    createdAt
  }
}

​
Error Responses

​
Contact Not Found

{
  "data": {
    "contactItem": null
  }
}

​
Not Authorized

If trying to access a contact from another organization: 
{
  "errors": [
    {
      "message": "Not authorized to access this contact",
      "extensions": {
        "code": "FORBIDDEN"
      }
    }
  ]
}