Grain (API Key)

🚀 Quickstart

Connect to Grain with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Grain (API Key).

Authorize Grain

Go to Connections -> Add Test Connection -> Authorize, then enter your Grain personal access token. Later, you’ll let your users do the same directly from your app.

Call the Grain API

Let’s make your first request to the Grain API by fetching details about the token. Replace the placeholders below with your Environment API key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/_/public-api/v2/token-info" \
  -H "Authorization: Bearer <NANGO-API-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });

const res = await nango.get({
    endpoint: '/_/public-api/v2/token-info',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.

📚 Grain integration guides

Nango-maintained guides for common use cases.

How do I link my Grain account?
Generate a Grain personal access token and connect it to Nango

Official docs: Grain API docs

API gotchas

Grain requires a Public-Api-Version header on every request. Nango sends 2026-10-01 by default. To pin another version, send Nango-Proxy-Public-Api-Version with your proxy request (or set the header in your function). See Grain’s versions page for current and deprecated versions.
A personal access token has the same access as the user who created it. It doesn’t expire, but the user can revoke it at any time.
To access all recordings in a workspace, use a workspace access token instead. Only workspace admins can generate one, and it isn’t available on all Grain plans.
List endpoints, such as POST /_/public-api/v2/recordings, use POST with a JSON body and cursor pagination. Pass the returned cursor to fetch the next page; a null cursor means there are no more results.
Rate limits apply per token: a burst of 30 requests, refilling at 2 requests per second. Requests over the limit return 429 with a Retry-After header.

🧩 Pre-built syncs & actions for Grain

Enable them in your dashboard. Extend and customize to fit your needs. No pre-built syncs or actions available yet.

Not seeing the integration you need? Build your own independently.

Overview

1,000+ APIs & Integrations

🚀 Quickstart

📚 Grain integration guides

API gotchas

🧩 Pre-built syncs & actions for Grain

​🚀 Quickstart

​📚 Grain integration guides

​API gotchas

​🧩 Pre-built syncs & actions for Grain

🚀 Quickstart

📚 Grain integration guides

API gotchas

🧩 Pre-built syncs & actions for Grain