Skip to main content

​
Mutation

mutation {
  addFeedbackItem(
    apiKey: String!
    input: NewFeedbackInput!
  ): FeedbackItem!
}

​
Parameters

​
apiKey
string
required
Your Tellscope API key
​
input
object
required
The feedback data to create

​
Response

Returns the created FeedbackItem.
​
id
string
Unique identifier of the created feedback
​
source
string
Source platform
​
title
string
Feedback title
​
content
string
Feedback content
​
author
string
Author name
​
email
string
Author email
​
sentiment
string
Sentiment value
​
status
string
Status (always unread for new feedback)
​
createdAt
datetime
Creation timestamp

​
Example

mutation {
  addFeedbackItem(
    apiKey: "tellscp_sk_YOUR_API_KEY"
    input: {
      source: "api"
      title: "Feature Request: Export to PDF"
      content: "It would be great if we could export reports directly to PDF format."
      author: "Alex Johnson"
      email: "[email protected]"
      sentiment: "neutral"
      metadata: {
        priority: "medium"
        category: "feature_request"
      }
    }
  ) {
    id
    title
    status
    createdAt
  }
}

curl -X POST https://api.tellscope.io/graphql \
  -H "Content-Type: application/json" \
  -d '{
    "query": "mutation { addFeedbackItem(apiKey: \"tellscp_sk_YOUR_API_KEY\", input: { source: \"api\", title: \"Bug report\", content: \"Found an issue...\" }) { id } }"
  }'

​
Use Cases

Webhook Integration

Create feedback from your own webhooks and integrations

Import Data

Bulk import feedback from external sources

Custom Forms

Submit feedback from custom forms on your website

Mobile Apps

Collect in-app feedback from your mobile applications