Fairing connector for AI agents

CALL ANY TOOL

2 tools for post-purchase surveys in Fairing: list your question stream with answer options and follow-up questions, and list customer responses with order, customer, attribution, and UTM details.

fairing_list_questions

List questions

List the questions in your Fairing question stream, including answer options and follow-up questions. Returns a data array of questions (id, prompt, type, customer_type, frequency_type, answer options, published_at and timestamps). Use to find a question_id before calling fairing_list_responses, or to review the survey configuration.

Parameters

Name

Type

Required

Description

include_targeting

boolean

Optional

Set to true to include each question's targeting rules in the result. Defaults to false. Default: `false`.

fairing_list_responses

List responses

Build your Agent

Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// Fairing tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["fairing"], toolNames: [
    "fairing_list_questions",
    "fairing_list_responses"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "Summarize how customers who ordered last week said they heard about us" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["fairing"] }, pageSize: 100,
});

const res = await openai.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Summarize how customers who ordered last week said they heard about us" }],
  tools,
});

// Execute the tool call with the user's vaulted Fairing API key
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["fairing"] }, pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Summarize how customers who ordered last week said they heard about us" }],
  tools,
});

// Tool call runs with the user's vaulted Fairing API key
await sk.tools.executeTool(msg.content, "user_123");

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["fairing"] }, pageSize: 100,
});

const agent = new Agent({
  name: "attribution_agent",
  model: "gemini-2.5-pro",
  instruction: "Fairing tools scoped to this user",
  tools,
});

await agent.run("Summarize how customers who ordered last week said they heard about us");

Try these prompts

Copy any prompt into your agent. Each maps directly to a Fairing tool. Click to copy, paste into your agent, done.

Questions

Copy the prompt

Copied

List the questions in our Fairing question stream.

Copy the prompt

Copied

Show the answer options for our attribution question.

Copy the prompt

Copied

Which of our questions have follow-up questions?

Responses

Copy the prompt

Copied

Pull survey responses from the last 7 days.

Copy the prompt

Copied

Show the answers to our attribution question from yesterday.

Copy the prompt

Copied

List this week's responses with their UTM source and order total.

Attribution

Copy the prompt

Copied

Summarize how customers said they heard about us this month.

Copy the prompt

Copied

Compare podcast answers this month with last month.

Copy the prompt

Copied

Which answers came with the highest average order total this week?

SEE HOW AUTH WORKS

Each user connects their own Fairing API key once, and Scalekit sends it with every call. Credentials stay vaulted, every call is scope checked, and every action is logged.

1

Authorize

Your user connects

Fairing

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

2

Store

Their

Fairing

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

3

Resolve

When your agent calls a

Fairing

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

4

Audit

Every

Fairing

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other marketing and analytics connectors.

GTM and RevOps Teams

Competitive intelligence briefing agent

Scans Gong calls for competitor mentions, matches each one to its Notion battlecard, and DMs every affected rep a single Slack digest per cycle. Every call runs as the PMM who owns the briefing, never a shared bot.

GTM and RevOps Teams

CRM AI agent

Reads the Granola transcript after every call, extracts next steps and updates the HubSpot record, drafts the follow-up in Gmail, and confirms in Slack, all on the rep's own delegated OAuth.

Test other agents

See the same per-user auth pattern across other marketing and analytics connectors.

GTM

Competitive intelligence briefing agent

Scan Gong calls for competitor mentions, match each one to its Notion battlecard, and DM every affected rep a single Slack digest.

GTM

CRM AI agent

Turn each Granola call transcript into a HubSpot record update, a drafted Gmail follow-up, and a Slack recap.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared Fairing API key looks fine in a demo. In production every response export looks like one service account, and you cannot tell which user triggered it. Scalekit resolves the credential of the actual user who triggered the agent, never a shared bot.

// shared key
audit → bot_service_account

// scalekit
audit → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

Fairing today. Ten connectors tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access Fairing as the user or through a shared key?

As the user. Each user connects their own Fairing API key once, and Scalekit sends it with every call. Every survey read is attributed to that user in your audit trail, not a shared service account.

Where is the Fairing API key stored?

In Scalekit's managed AES-256 token vault, namespaced per tenant. To rotate it, the user reconnects with a new API key. Revocation is a single dashboard action. Credentials never appear in prompts, logs, or LLM context.

Can I limit what the agent does in Fairing?

Yes. Both Fairing tools are read-only, so the agent can list questions and responses but cannot change your survey. Filter by tool name in listScopedTools to expose only one of them. Scalekit also enforces scope checks before every API call.

What happens when a user revokes Fairing access?

The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

What does each Fairing response include?

The question and answer text, the order ID and total, the customer email, UTM fields, and timestamps. fairing_list_responses filters by question_id or time window, and fairing_list_questions returns the question IDs and wording to filter on.

Fairing MCP server for AI agents

Tools your attribution agent reaches for on Fairing, scoped per user.