--- title: "Connect Google Sheets and Poptin - APIANT.ai" description: "When \"Aggregate Metric Changed\" fires in Google Sheets, your agent runs \"Update contact status\" in Poptin." canonical: "https://apiant.ai/connect/google-sheets-to-poptin" --- # Connect Google Sheets and Poptin When **Aggregate Metric Changed** fires in [Google Sheets](https://apiant.ai/connections/google-sheets), your agent runs **Update contact status** in [Poptin](https://apiant.ai/connections/poptin), or **New Contact** in Poptin to **Add Row** in Google Sheets. Describe the whole flow and it is built, tested on every scenario and kept running. Google Sheets **16** triggers Google Sheets **46** actions Poptin **2** triggers Poptin **31** actions What the catalog holds today. Ask for anything missing and your agent reads the API documentation and adds it. ## What do you want Google Sheets and Poptin to do together? Give your AI client this address. `https://mcp.apiant.ai` One connection does both: ask your client to act in an app once, or have it build an automation that keeps running. Any client that takes a remote MCP server. Nothing to install. Create your free account, then sign in once in your browser. ### Set it up in your client ### Claude Code Run this in the directory you want to work in. `claude mcp add --transport http -s project apiant-ai https://mcp.apiant.ai` Start Claude Code there, approve the server, and sign in in the browser page it opens. [Claude Code guide (opens in a new tab)](https://apiant.ai/docs/mcp/claude-code) ### Claude, web and desktop Open Customize, then Connectors, then Add custom connector, and paste the address. On Team and Enterprise an owner adds it first. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) ### Cursor Add the address to your MCP configuration as a server URL. Cursor signs you in in your browser. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) ### Zed Open Settings, then AI, then MCP Servers, then Add Server, then Add Remote Server. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) ### Codex and the ChatGPT desktop app Open Settings, then MCP servers, then Add server, and choose Streamable HTTP. From the terminal, Codex takes the address with its own add command and then signs you in. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) ### Any other MCP client Paste the address where the client asks for a remote MCP server URL, and name the server apiant-ai where it lets you. APIANT's skills reach the client over the same connection. [Setup guide (opens in a new tab)](https://apiant.ai/docs/mcp) Example flows ## What Google Sheets and Poptin can do together ### From Google Sheets to Poptin - When **Aggregate Metric Changed** in Google Sheets then **Update contact status** in Poptin - When **Cell Range Values Changed** in Google Sheets then **Create preference** in Poptin ### From Poptin to Google Sheets - When **New Contact** in Poptin then **Add Row** in Google Sheets - When **New Lead** in Poptin then **Create Multiple Spreadsheet Rows** in Google Sheets Starting points drawn from the triggers and actions in the catalog today. Describe the flow you need, at any depth, and your agent builds it and tests every scenario before it ships. Everything your agent can do with Google Sheets and Poptin ## Triggers and actions 18 triggers · 77 actions - Trigger **Aggregate Metric Changed** Fires when an aggregate metric (sum/avg/count/…) over a column changes. - Trigger **Cell Range Values Changed** Fires when the values in a specific cell range change. - Trigger **Conditional Format Rule Changed** Fires when a conditional-format rule changes. - Trigger **Data Validation Rule Changed** Fires when a data-validation rule changes. - Trigger **Developer Metadata Changed** Fires when developer metadata changes. - Trigger **Filtered Range Values Changed** Fires when the values in a filtered range change. - Trigger **New Rows** Fires when new rows are appended to a Google Sheet. - Trigger **New Sheet Added** Fires when a new sheet (tab) is added to a spreadsheet. - Trigger **New Spreadsheet Created** Fires when a new spreadsheet is created in the account. - Trigger **Spreadsheet Metadata Changed** Fires when spreadsheet metadata changes. - Trigger **Spreadsheet Properties Changed** Fires when spreadsheet properties change. - Trigger **Spreadsheet Row Changed** Fires when a row matching a query changes. - Trigger **Spreadsheet Search Match** Fires when a spreadsheet matching search criteria is found. - Trigger **Table Query Result Changed** Fires when the result of a SQL-style table query changes. - Trigger **Table Schema Changed** Fires when a table's column schema changes. - Trigger **Worksheet Names Changed** Fires when worksheet (tab) names change. - Action **Add Row** Append a row to a Google Sheet - Action **Aggregate Column Data** Read a range and compute an aggregate (sum|avg|min|max|count) over one column, skipping blank/non-numeric cells (so a header row is skipped automatically). - Action **Auto-Resize Rows or Columns** Auto-fit row heights or column widths over an index range via autoResizeDimensions. - Action **Change Sheet Properties** Update a worksheet's grid properties (row/column count) using an explicit field mask. - Action **Clear Basic Filter** Remove the basic filter from a sheet via clearBasicFilter. - Action **Clear Spreadsheet Row(s)** Clear the values in a range (formatting preserved). - Action **Copy Range** Copy a source cell range to a destination range within the spreadsheet. - Action **Copy Worksheet** Copy a worksheet into a destination spreadsheet. - Action **Create Chart** Add a basic embedded chart (column/bar/line/etc.) built from a domain range and a series range on a sheet. Returns the new chartId. - Action **Create Conditional Formatting Rule** Add a boolean conditional formatting rule (e.g. NUMBER_GREATER) that colors matching cells. - Action **Create Multiple Spreadsheet Rows** Append many rows in one call. - Action **Create Spreadsheet** Create a new Google Sheets spreadsheet with the given title. - Action **Create Spreadsheet Column** Insert a blank column at a given index. - Action **Create Spreadsheet Row** Append a single row of values to a sheet range. - Action **Create Spreadsheet Row at Top** Insert a blank row just below the header (row 2), then write the given values into it in one operation. - Action **Create Worksheet** Add a new worksheet (tab) to an existing spreadsheet. - Action **Delete Chart** Delete an embedded chart via deleteEmbeddedObject. - Action **Delete Sheet** Delete a worksheet from a spreadsheet by sheetId (gid). - Action **Delete Spreadsheet Row(s)** Delete a contiguous block of rows by index. - Action **Find and Replace** Find and replace text across the spreadsheet. Supply EXACTLY ONE scope: all_sheets=true OR sheet_id. Leave the other unset (do not pass all_sheets=false together with sheet_id). - Action **Find Spreadsheet** Find spreadsheets by exact name via the Drive API (cross-host through the googlesheets connection). - Action **Find Worksheet** Return the worksheet whose title matches the given title (sheet_id/index/found), reading the spreadsheet's sheet properties. - Action **Format Cell Range** Apply background color and bold formatting to a cell range via repeatCell. - Action **Format Spreadsheet Row** Apply a background color across an entire row via repeatCell over a row range. - Action **Get Conditional Format Rules** List all conditional-format rules on each sheet (paired with the sheetId so a follow-up update can target a rule by index). - Action **Get Data Range** Read all values in one or more ranges via batchGet. - Action **Get Data Validation Rules** Read the data-validation rule set on every cell of a range (per-cell dataValidation, via includeGridData with a field mask). - Action **Get Many Spreadsheet Rows (Advanced)** Read multiple ranges at once via batchGet. - Action **Get Row by ID** Read a single row range. NOTE: Google Sheets has no row ID; the row number IS the identity. - Action **Get Sheet Names** Return the titles of all sheets (tabs) in the spreadsheet. - Action **Get Spreadsheet by ID** Fetch spreadsheet metadata (title, sheets, gids, grid properties). - Action **List Charts** List all embedded charts (chartId + title) across every sheet in the spreadsheet. - Action **Lookup Spreadsheet Row** Read a range and return the FIRST row whose cell at column_index equals match_value (Sheets has no server-side filter; this op filters the returned rows). - Action **Lookup Spreadsheet Rows (Advanced)** Read multiple ranges via batchGet and return ALL rows whose cell at column_index equals match_value (Sheets has no server-side filter; this op filters the returned rows). - Action **Move Chart** Reposition an embedded chart to a new overlay anchor cell via updateEmbeddedObjectPosition. - Action **Rename Sheet** Rename a worksheet's title. - Action **Search Spreadsheets** Search spreadsheets by name substring (or full-text) via the Drive API, cross-host through the googlesheets connection. - Action **Set Basic Filter** Apply a basic filter to a range on a sheet via setBasicFilter. - Action **Set Data Validation** Apply a ONE_OF_LIST dropdown data-validation rule to a cell range. - Action **Sort Range** Sort a cell range by one column in ascending or descending order. - Action **Update Chart** Replace an existing chart's spec (title, chart type, domain/series ranges) via updateChartSpec. - Action **Update Conditional Format Rules** Replace an existing conditional-format rule (identified by its index on the sheet) with a new boolean rule. - Action **Update Data Validation Rule** Overwrite the data-validation rule on a cell range with a ONE_OF_LIST dropdown (same endpoint as create; setDataValidation replaces whatever rule the range held). - Action **Update Spreadsheet Row** Overwrite the values at a specific range. - Action **Update Spreadsheet Row(s)** Update one or more disjoint ranges in a single batch. - Action **Upsert Row** Read a range, find the row whose column_index cell equals match_value; UPDATE that row when found, otherwise APPEND a new row. One adaptive write request (method+path chosen by the match script). - Trigger **New Contact** Triggers when a new contact is added to your Poptin contact list. - Trigger **New Lead** Triggers when a visitor submits a Poptin form, creating a new lead (conversion). - Action **Campaign Analytics** See how your email campaigns performed overall in a date range (sends, opens, clicks, bounces) - the same metrics as a single campaign, rolled up. - Action **Create preference** Add a new subscription preference topic (name and optional description) that contacts can be opted into. **423** if the account is locked for processing. - Action **Delete campaign** Permanently delete a campaign you no longer need. Campaigns that are `sending` or `queued` cannot be deleted (**422**). Allowed while under review. Returns **204** with no body. - Action **Delete contact** Permanently remove one contact by public id (`uid`). For many deletions, prefer **Bulk delete contacts (JSON)**. Returns **204** with no body. **423** if the account is locked for processing. - Action **Delete conversion** Remove lead personal details from a conversion while the row may be kept for aggregate stats. Returns **204**. **423** if the account is locked for processing. - Action **Delete poptin** Soft-delete a popup/form (recoverable by support for a limited time). A/B versions are reassigned as in the dashboard. Returns **204**. **423** if the account is locked for processing. - Action **Delete preference** Remove a subscription preference topic you no longer offer. Contacts lose this preference association. **423** if the account is locked for processing. - Action **Delete property** Remove a custom property you no longer need. Built-in/default properties cannot be deleted (**406**). **423** if the account is locked for processing. - Action **End campaign** Mark a `paused` campaign as `completed` so it will not continue sending - use this to close out a send early. Ending an already `completed` campaign is a no-op (**200**). **422** for other statuses or when the campaign is under review. - Action **List campaigns** Browse email campaigns on your account (with optional name/status filters) so you can find a campaign to inspect or control. Paginated (`per_page` default **10**, max **100**). - Action **List contacts** Browse and search people on your contact list so you can sync a CRM, audit who is subscribed, or find a contact before updating them. - Action **List conversions** Browse leads and actions captured from your popups/forms so you can sync them to another system or review recent activity. - Action **List poptins** Browse your popups and forms with per-Poptin aggregate metrics so you can rank performers or find a Poptin to inspect. - Action **List preferences** List subscription preference topics on your account so you can build a preference center or map topic ids when syncing contacts. Paginated (`per_page` default **50**, max **100**). - Action **List properties** List the contact fields available on your account so you can map forms or syncs to the right keys. Paginated (`per_page` default **50**, max **100**). - Action **Pause campaign** Temporarily stop a campaign that is currently `sending` or `queued` - for example while you fix content or list issues. Pausing an already `paused` campaign is a no-op (**200**). **422** for other statuses or when the campaign is under review. - Action **Pause poptin** Turn off an active popup/form so it stops showing on your site. Pausing an already `inactive` poptin is a no-op (**200**). **422** for statuses that cannot be paused (for example `draft`). - Action **Poptin Analytics** See account-wide popup and form results for a time period - visitors, views, conversions, growth, and rates - the same overview style numbers you would check in the dashboard. - Action **Refresh poptin stats** Ask Poptin to recompute popup/form aggregate stats when the cached overview looks stale. - Action **Rename poptin** Change the display name of a popup/form. Name must be 2–256 characters and unique on the account (**422** if taken). - Action **Resume campaign** Continue a `paused` campaign, or retry one that entered an `error` state. Resuming an already `sending`, `queued`, or `scheduled` campaign is a no-op (**200**), except when under review (**422**). **422** for other statuses or when the campaign is under review. - Action **Resume poptin** Turn an inactive popup/form back on. Resuming an already `active` poptin is a no-op (**200**). **422** for statuses that cannot be resumed (for example `draft`). - Action **Show bulk job status** Poll a background bulk job until `status` is `done` or `failed`. Requires `object_id` and `object_name` from the **202** response of a queuing operation. - Action **Show campaign** Get one campaign by public id (`uid`), including its delivery status and performance statistics (sends, opens, clicks, bounces, and rates). A/B campaigns also include `ab`, `ab_test_percentage`, and per-variant details (`type`, `has_body`, headers). During an active A/B test, top-level `subject` / ` - Action **Show contact** Get one contact by public id (`uid`), including field values, tags, preferences, and subscription status - useful before an update or to verify a sync. - Action **Show conversion** Get one conversion by public id (`uid`) - for example to fetch full lead details after a webhook or list sync. Pass `include=extra_fields` to resolve submitted input fields. - Action **Show poptin** Get one popup or form by public id (`uid`) with its aggregate metrics. A/B parents include nested versions; A/B versions include the parent’s identity and metrics. - Action **Show preference** Get one preference topic by public id (`uid`). Pass `include=contacts_count` when you need how many contacts currently have this preference. - Action **Show property** Get one contact property, including its type and options, so you can map forms or syncs to the right field. - Action **Update contact status** Change only a contact’s subscription status (for example subscribe, unsubscribe, or mark as bounced) without rewriting their other fields. - Action **Update preference** Update a preference topic without changing which contacts are opted in. **423** if the account is locked for processing. ## Each app on its own - [ **Google Sheets** Google Sheets is Google's online spreadsheet app for creating, editing and sharing spreadsheets.](https://apiant.ai/connections/google-sheets) - [ **Poptin** Poptin is a free lead capture platform that lets you create engaging web and mobile popups and improve your...](https://apiant.ai/connections/poptin) Reviews ## What our customers say ## More from Google Sheets - [ **Google Sheets to Stripe** Stripe is a payment processing platform for online businesses.](https://apiant.ai/connect/google-sheets-to-stripe) - [ **Google Sheets to QuickBooks Online** QuickBooks Online accounting — manage customers, invoices, bills, payments, vendors, expenses, and more via...](https://apiant.ai/connect/google-sheets-to-quickbooks-online) - [ **Google Sheets to Notion** A new tool that blends your everyday work apps into one. It's the all-in-one workspace for you and your team.](https://apiant.ai/connect/google-sheets-to-notion) - [ **Google Sheets to Airtable** Organize anything with Airtable, a modern database created for everyone.](https://apiant.ai/connect/google-sheets-to-airtable) - [ **Google Sheets to Trello** Trello is a visual collaboration tool that organizes projects into boards, lists, and cards.](https://apiant.ai/connect/google-sheets-to-trello) - [ **Google Sheets to Intercom** Intercom is a customer communications platform for support, engagement, and marketing.](https://apiant.ai/connect/google-sheets-to-intercom) ## More into Poptin - [ **HubSpot to Poptin** HubSpot is your all-in-one stop for all of your marketing software needs.](https://apiant.ai/connect/hubspot-to-poptin) - [ **Gmail to Poptin** Gmail is Google’s email service, featuring spam protection, search functions, and seamless integration with...](https://apiant.ai/connect/gmail-to-poptin) - [ **Google Calendar to Poptin** Google Calendar is a time management tool providing scheduling features, event reminders, and integration...](https://apiant.ai/connect/google-calendar-to-poptin) - [ **Google Drive to Poptin** Google Drive is a cloud storage solution for uploading, sharing, and collaborating on files across devices...](https://apiant.ai/connect/google-drive-to-poptin) - [ **Mailchimp to Poptin** Mailchimp marketing automation and email platform.](https://apiant.ai/connect/mailchimp-to-poptin) - [ **Pipedrive to Poptin** Pipedrive is a sales CRM and pipeline management tool.](https://apiant.ai/connect/pipedrive-to-poptin) Questions ## Google Sheets and Poptin, answered ### ### What can start an automation from Google Sheets? Any of Google Sheets's 16 triggers in the catalog, including Aggregate Metric Changed, Cell Range Values Changed, Conditional Format Rule Changed and Data Validation Rule Changed. Describe the moment in plain language and your agent picks the right one. ### ### What can your agent do in Poptin when something happens in Google Sheets? Any of Poptin's 31 actions, including Create preference, Update contact status, Update preference and Campaign Analytics. Your agent maps the data both ways and tests every scenario before it ships. ### ### Can it also run from Poptin to Google Sheets? Yes. When something happens in Poptin, your agent can act in Google Sheets too. This page covers both directions: Poptin's triggers and Google Sheets's actions are listed here as well. ### ### Do I have to build a connector for Google Sheets or Poptin? No. Both are in the catalog with their triggers and actions. You describe the automation; your agent builds it, tests every scenario and keeps it running. ### ### Can my AI client use Google Sheets and Poptin without building an automation? Yes. With your AI client connected to APIANT, ask it to do something in either app once and it runs that action on the spot. Ask for an automation and your agent builds it, tests every scenario and keeps it running. One connection covers both. ### ### What happens when something fails? Your agent works that out for you. It plans the failure paths along with the happy path, then tests every scenario before it ships. ### ### Is there a free plan? Yes. Every plan includes the agent, including free, and building from your own AI client spends no assistant credits.