Skip to main content

​
1. Overview

Connect your Grain workspace to Ana to analyze meeting activity, surface insights from transcripts, and track engagement across your team’s calls. Ana can fetch recording details, search meeting notes, and summarize highlights from past conversations.
Store your Grain API key as an API Connector in TextQL, and Ana will be able to query your meeting recordings, transcripts, and highlights.

​
2. Prerequisites

You’ll need:
  • A TextQL account with permissions to add API connectors
  • A Grain account to generate a Personal Access Token (PAT)
  • Or a Grain admin account if you are generating a Workspace Access Token (WAT)

​
Which token should I use?

Token TypeAccess ScopeWho Can Generate
PAT (Personal Access Token)Your own recordings onlyAny Grain member
WAT (Workspace Access Token)All recordings across the workspaceWorkspace admins only
If you are setting this up on behalf of your team, use a WAT. A PAT will limit Ana to your personal data only, which may cause incomplete results for shared workflows.

​
3. Capabilities

Once configured, Ana can:
  • Fetch recording details (title, date, duration, participants)
  • Search and filter meetings by topic, date, or speaker
  • Analyze engagement across your team’s calls
  • Surface highlights and key moments from transcripts
  • Generate reports on meeting activity and conversation trends
The integration uses API key authentication with read-only access to your Grain workspace data.

​
4. Setup Instructions

​
Step 1: Generate Your Grain API Key

Before configuring TextQL, you’ll need an API key from Grain.
Grain API token generation page showing Personal and Workspace API sections
  1. Log in to Grain.
  2. Click your name at the top-left corner, below your organization name.
  3. Go to My Account.
  4. Scroll down to Integrations and click API.
  5. Under the relevant section, click Generate token:
    • Personal access token — for querying your own meetings
    • Workspace access token — for querying all workspace meetings (admins only)
  6. Copy the token value immediately after it is generated.
Only workspace admins can generate a WAT. If you don’t see the Workspace API section, ask your Grain admin to generate the token and share it with you securely.

​
Step 2: Add Grain as an API Connector in TextQL

TextQL Add More API Connectors panel with Grain highlighted
  1. Go to app.textql.com and sign in.
  2. In the bottom-left sidebar, click Connectors.
  3. Select the APIs tab.
  4. Navigate to Add more API connectors and click Grain.
  5. In the configuration panel, fill in the following fields:
    • Name — a label for this connection (e.g. Grain Workspace or Grain - [Your Name])
    • Access token — paste the key you copied in Step 1
  6. Click Save.
Name your connector clearly, including the token type and owner, so it’s easy to audit and rotate keys within your TextQL workspace.

​
Step 3: Verify the Connection

Ana chat showing a list of recent Grain recordings returned after querying the connector
Once saved, confirm the connector is active:
  1. In Connectors > APIs, check that Grain appears in your list of active connectors.
  2. Open a new Ana chat and ask a simple query, such as: “List my most recent Grain recordings.”
If Ana returns results, the connection is working. If you see an error, refer to the Troubleshooting section below.

​
5. Usage Examples

Once your Grain connector is live, try asking Ana:
  • “What were the key takeaways from my last 5 sales calls?”
  • “Summarize the highlights from today’s morning meeting.”
  • “Which team members have had the most customer calls this month?” (WAT required)
  • “Pull the transcript from my sales call with TextQL on June 2.”

​
6. Troubleshooting

SymptomLikely CauseFix
401 UnauthorizedToken expired or invalidRe-authorize and generate a new token in Grain
404 Not FoundHost configuration issueGo to Connectors > APIs, click Edit on your Grain connector, then Advanced. Under Hosts, confirm both https://api.grain.com:443 and https://grain.com:443 are listed.

​
7. Setup Checklist

Before moving on, confirm you’ve completed each step:
  • Generated an access token from Grain (PAT or WAT)
  • Added Grain as an API connector in TextQL under Connectors > APIs
  • Pasted your access token and saved the connector
  • Verified the connection by running a test query in Ana

​
Need Help?

Contact support@textql.com.