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?

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

Grain's API & Integrations page showing both Personal and Workspace Access Token sections — generate a WAT here if you need workspace-wide access

  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

Grain highlighted in the TextQL API Connectors setup panel — select it to open the connector configuration form

  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

Ana returning a list of recent workspace recordings after a successful Grain connection — a good first query to confirm everything is working

Once saved, confirm the connector is active:
  1. Click on the Grain connector and select Test Connection at the bottom of the panel.
  • A successful setup will return Connection successful (200).
  • If the test fails, refer to the Troubleshooting section for next steps.

​
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

​
7. Security Notes

  • Grain API tokens do not expire automatically. You are responsible for rotating them periodically or immediately if compromised.
  • A PAT grants access to your personal recordings only. A WAT grants access to all workspace recordings — treat it accordingly and limit who has visibility to it in TextQL.
  • Your API token is stored securely in TextQL as an API Connector and is not exposed in Ana’s responses or logs.
  • To revoke Ana’s access, go to Grain → My Account → Integrations → API and delete the token. Then remove or update the connector in TextQL under Connectors → APIs.
  • For more information on how Grain handles PAT and WAT, refer to Grain’s official documentation.

​
Need Help?

For further assistance, please contact support@textql.com.

​
Privacy Policy

For information about how we handle your data and protect your privacy, please review our Privacy Policy.