Get Contact

Query

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

Parameters

string

required

Your Tellscope API key

string

required

The unique identifier of the contact

Response

Returns a single ContactItem or null if not found.

string

Unique identifier

string

Full name of the contact

string

Email address

string

Phone number

string

Company or organization name

string

Job title or role

string

Geographic location

array

Tags assigned to this contact

integer

Total number of feedback items from this contact

datetime

Date of most recent interaction

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
  }
}

{
  "data": {
    "contactItem": {
      "id": "cnt_abc123",
      "name": "John Smith",
      "email": "john@acme.com",
      "phone": "+1 (555) 123-4567",
      "company": "Acme Corp",
      "title": "Product Manager",
      "location": "San Francisco, CA",
      "tags": ["enterprise", "active", "champion"],
      "totalFeedbacks": 12,
      "lastInteraction": "2024-01-18T15:30:00Z",
      "createdAt": "2023-06-15T10:00:00Z"
    }
  }
}

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"
      }
    }
  ]
}

Overview

Feedback

Contacts

Accounts

Query

Parameters

Response

Example

Error Responses

Contact Not Found

Not Authorized