Introduction

API Overview

The Tellscope API is built on GraphQL, giving you the flexibility to request exactly the data you need. All requests are made to a single endpoint:

POST https://api.tellscope.io/graphql

Operation	Description
`feedbackItems`	List feedback with filters and pagination
`feedbackItem`	Get a single feedback by ID
`contactItems`	List contacts with search and pagination
`contactItem`	Get a single contact by ID
`accountItems`	List accounts with search and pagination
`accountItem`	Get a single account by ID

Operation	Description
`addFeedbackItem`	Create new feedback
`removeFeedbackItem`	Delete feedback by ID

All requests must be POST requests with a JSON body containing:

{
  "query": "your GraphQL query or mutation",
  "variables": { }  // optional
}

Responses follow the standard GraphQL format:

{
  "data": {
    // your requested data
  },
  "errors": [
    // any errors that occurred
  ]
}

Rate limits are applied per API key. Contact support if you need higher limits.

The API returns standard GraphQL errors:

{
  "errors": [
    {
      "message": "Invalid API key",
      "extensions": {
        "code": "UNAUTHENTICATED"
      }
    }
  ]
}

Common error codes:

Code	Description
`UNAUTHENTICATED`	Invalid or missing API key
`FORBIDDEN`	Valid key but no access to resource
`NOT_FOUND`	Resource does not exist
`BAD_REQUEST`	Invalid query or parameters