Or, how to import custom data into Viable

Getting your API key

  1. In Viable, click on "Admin" -> "Integrations"
  2. Scroll down the page
  3. Copy your API key

POSTing data to the ingress endpoint

The https://app.askviable.com/api/{API_KEY}/ingress endpoint allows you to POST custom data into Viable. It accepts a JSON body with these attributes:

  "text": "Some text to ingest",
  "text_created_at": "2022-04-20T16:20:00+00:00",
  "email": "[email protected]",
  "source": "my-source",
  "source_id": "1234567890",
  "thread_id": "9876543210"
  "metadata": {
    "Label One": "Value",
    "Label Two": "Next Value"

An alternate method for sending metadata:

"metadata": [
  {"type": "Tag", "value": "name of tag 1"},
  {"type": "Tag", "value": "name of tag 2"},
  {"type": "Tag", "value": "name of tag 2"},
  {"type": "City", "value": "Singapore"},
  // ... other metadata here