Skip to main content

​
Query

query {
  contactItems(
    apiKey: String!
    skip: Int
    take: Int
    search: String
  ): ContactItemList!
}

​
Parameters

​
apiKey
string
required
Your Tellscope API key
​
skip
integer
default:"0"
Number of items to skip for pagination
​
take
integer
default:"50"
Number of items to return (max 100)
​
search
string
Search term to filter contacts by name, email, or company

​
Response

​
items
array
Array of contact items
​
total
integer
Total count of matching contacts

​
Example

query {
  contactItems(
    apiKey: "tellscp_sk_YOUR_API_KEY"
    take: 20
    search: "acme"
  ) {
    items {
      id
      name
      email
      company
      title
      totalFeedbacks
      lastInteraction
    }
    total
  }
}

curl -X POST https://api.tellscope.io/graphql \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query { contactItems(apiKey: \"tellscp_sk_YOUR_API_KEY\", take: 20, search: \"acme\") { items { id name email company } total } }"
  }'
Contacts are read-only via the public API. To create or update contacts, use the Tellscope dashboard or integrations.