API

01Authenticate

Take your API key from Settings → Integrations → Survey and pass it as a Bearer token:

Authorization: Bearer YOUR_API_KEY

02Send one item

POST https://api.annsa.ai/feedback

{
  "text": "The export is too slow on large datasets",
  "customer_name": "Jane Smith",
  "customer_email": "jane@example.com",
  "revenue_band": 199,
  "source": "api"
}

03Send a batch

Same endpoint, an items array instead. Up to 1,000 items per request, and the response carries a result for each one.

{
  "items": [
    {
      "text": "Can't find the export button",
      "customer_email": "alex@example.com",
      "revenue_band": 49
    },
    {
      "text": "Love the new dashboard layout",
      "customer_name": "Sam Lee"
    }
  ]
}

04The fields

Field	Type	Required	Description
`text`	string	Yes	The feedback content
`customer_name`	string	No	Appears in Customer Voice quotes
`customer_email`	string	No	Enables close-the-loop notifications
`revenue_band`	number	No	What the customer pays you, e.g. `199`. Legacy band strings (`enterprise`/`paid`/`free`) still accepted
`sku`	string	No	Product tier or plan identifier
`external_id`	string	No	Your own ID, for deduplication and tracking
`source`	string	No	Defaults to `api`

05Duplicates are skipped

Annsa hashes the text, so the same content submitted twice creates one item. Pass external_id and the second submission is skipped on that id regardless of what the text says.

06What comes back

{
  "id": "fb_a1b2c3d4",
  "status": "accepted",
  "deduplicated": false
}

For a batch, you get one result per item.

07Rate limits

100 requests per minute per API key, and 1,000 items per batch request.

08Tagging the source

Setting source is what makes Activity Log filtering useful.

Source	Use for
`api`	Programmatic submissions (the default)
`widget`	Survey embed (set automatically)
`csv`	CSV imports (set automatically)
`slack`	Slack integration (set automatically)

09Transcripts too

POST https://api.annsa.ai/transcripts/upload

Same auth header. The body takes text for the transcript content, and optionally transcript_type (interview, sales_call, support, other) plus customer metadata.

Questions go to support@annsa.ai.