Ctrlk
HomeSign In
For the complete documentation index, see llms.txt. This page is also available as Markdown.

G2

Integrate your Workflow with G2

The G2 Integration step allows you to connect your AirOps workflows directly with your G2 account. This integration enables you to pull product data, reviews, and survey questions from G2 programmatically.

This integration connects to G2's Data API, which is a separate, paid G2 product. It is not the same as the public g2.com website, and it only returns the products your G2 account is licensed to access. Being able to find a product on g2.com does not mean it is available through the API. If your G2 plan does not include Data API access, or no products are mapped to your account, actions will return no results. Confirm your access with your G2 administrator.

How to Configure the G2 Integration Step

Authentication

Before using the G2 integration in your workflows, you must first connect your G2 account in the AirOps Settings:

  1. Open Settings → Integrations.

  2. Find the G2 section and click Configure.

  3. Complete the OAuth authentication process by granting AirOps the necessary permissions.

MCP Connectors and Playbooks

You can also connect G2 through Settings → MCP Connectors and use it in Playbooks. AirOps uses its OAuth app for the standard connector flow.

  1. Open Settings → MCP Connectors and connect G2.

  2. Open the Playbook editor.

  3. Open the Tools panel and turn on G2.

  4. Describe what G2 review data the Playbook should use during the content creation run.

Use your own G2 OAuth app

If your team uses its own scoped OAuth app, complete the advanced setup before you continue the G2 OAuth flow in AirOps.

  1. In My.G2, open your G2 OAuth app and find the client ID and secret ID.

  2. In AirOps, paste both values into Advanced OAuth client settings.

  3. Click Save, then copy the AirOps callback URL: https://app.airops.com/api/mcp_connectors/oauth/callback.

  4. Return to the G2 OAuth app in My.G2 and add the callback URL to the redirect URIs.

  5. Return to AirOps and continue the OAuth flow.

Action Types

The G2 Integration supports the following actions:

  • Get Products: Retrieve a list of products listed on G2

  • Search Products: Search for G2 products by keyword or topic

  • Get Survey Questions: Retrieve the definitions of the questions G2 asks in product surveys. This does not return review answers. Use Get Reviews for the written feedback reviewers left.

  • Get Reviews: Retrieve reviews for a specific product

Action-Specific Parameters

Get Products

  • Product Name (Optional): Filter by exact product name (e.g. Salesforce)

  • Slug (Optional): Filter by G2 product URL slug (e.g. salesforce-crm)

  • Search Query (Optional): Free-text search across product names (e.g. CRM)

  • Page Size (Optional): Number of results per page (max 100, default 10)

  • Page Number (Optional): Page number to retrieve (default 1)

Search Products

  • Keyword (Required): Search for G2 products by keyword or topic (e.g. CRM, project management)

  • Page Size (Optional): Number of results per page (max 100, default 10)

  • Page Number (Optional): Page number to retrieve (default 1)

Get Survey Questions

  • Updated After (Optional): Return questions updated after this date (RFC3339 format, e.g. 2024-01-01T00:00:00Z)

  • Updated Before (Optional): Return questions updated before this date (RFC3339 format)

  • Page Size (Optional): Number of results per page (max 100, default 10)

  • Page Number (Optional): Page number to retrieve (default 1)

Get Reviews

  • Product ID (Required): The G2 product UUID to fetch reviews for (e.g. 5079d5b8-c6f0-4b0e-96a9-44b8c9d3a6f1). This is not the product name. To find it, run a Get Products or Search Products step first, then copy the id of the product you want from its results.

  • Created After (Optional): Return reviews created after this date (RFC3339 format, e.g. 2024-01-01T00:00:00Z)

  • Created Before (Optional): Return reviews created before this date (RFC3339 format)

  • Updated After (Optional): Return reviews updated after this date (RFC3339 format)

  • Updated Before (Optional): Return reviews updated before this date (RFC3339 format)

  • Minimum Stars (Optional): Return only reviews with a star rating at or above this value (1–5)

  • Maximum Stars (Optional): Return only reviews with a star rating at or below this value (1–5)

  • Page Size (Optional): Number of results per page (max 100, default 10)

  • Page Number (Optional): Page number to retrieve (default 1)

What the Step Returns

Each action returns a simplified response:

  • data: the list of records found (products, reviews, or survey questions).

  • record_count: the total number of matching records.

  • links: next and prev pagination links, when available.

  • message: included only when data is empty, explaining the most likely cause (see "Why am I not getting any results?" below).

For Get Survey Questions, data contains G2's survey question definitions, and record_count reflects the total number of questions across G2's catalog, not a count scoped to a product.

Common Use Cases

  • Searching for competitor products by keyword and pulling their reviews for competitive analysis

  • Filtering reviews by star rating to surface promoter or detractor feedback at scale

  • Summarizing customer feedback with an AI step to surface key themes

  • Monitoring sentiment trends over time using date-filtered review data

  • Enriching content with real social proof and review quotes from G2

Why am I not getting any results?

If an action runs successfully but returns no products or reviews, it almost always means the connected G2 account has nothing to return, not that the step is broken. The most common causes are:

  • Your G2 plan does not include Data API access. This integration uses G2's paid Data API. A standard or free G2 login does not have this access.

  • No products are mapped to your account. The API only returns products your account is licensed to access, which are mapped on G2's side (for example via the G2 Partner Dashboard). It does not search the full public g2.com catalog.

  • You are looking for a product you do not own. Pulling other companies' products and reviews (for competitive research) requires broader catalog access in your G2 agreement.

In all of these cases, the fix is on the G2 side. Confirm with your G2 administrator or account representative what your Data API access includes and that the products you need are mapped to your account.

Error Handling

By default, the G2 Integration step will terminate the workflow if it fails. You can configure it to continue by selecting "Continue" instead of "Terminate Workflow" in the step settings.

Last updated

Was this helpful?