Google Sheets Safe Upsert (Validated Diff)
Pricing
from $0.02 / verified write
Upsert JSON rows into a Google Sheets tab safely: typed schema validation, a cell-by-cell diff preview, and only the approved diff is written. Same operationId sent 10 times = written once. Made for AI agents, MCP clients and automations.
You can access the Google Sheets Safe Upsert (Validated Diff) programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
# Set API token$API_TOKEN=<YOUR_API_TOKEN>
# Prepare Actor input$cat > input.json << 'EOF'<{< "spreadsheet": "https://docs.google.com/spreadsheets/d/1EZLnhDCfmhGUnlubmGE-WIfFie8KrJnJkKE2w9f-4AQ/edit",< "sheetName": "Demo",< "keyColumns": [< "sku"< ],< "columns": [< {< "name": "sku",< "type": "string",< "pattern": "[A-Z]{3}-\\d{3}"< },< {< "name": "qty",< "type": "integer",< "min": 0< },< {< "name": "price",< "type": "number",< "min": 0< },< {< "name": "active",< "type": "boolean"< },< {< "name": "updated",< "type": "date"< }< ],< "rows": [< {< "sku": "ABC-001",< "qty": 5,< "price": 9.5,< "active": true,< "updated": "2026-10-21"< },< {< "sku": "ABC-002",< "qty": 0,< "price": 12,< "active": false,< "updated": "2026-10-20"< }< ]<}<EOF
# Run the Actor using an HTTP API# See the full API reference at https://docs.apify.com/api/v2$curl "https://api.apify.com/v2/actors/kumo-data-tools~google-sheets-safe-upsert/runs?token=$API_TOKEN" \< -X POST \< -d @input.json \< -H 'Content-Type: application/json'Below, you can find a list of relevant HTTP API endpoints for calling the Google Sheets Safe Upsert (Validated Diff) Actor. For this, you’ll need an Apify account. Replace <YOUR_API_TOKEN> in the URLs with your Apify API token, which you can find under API & Integrations in Apify Console. For details, see the API reference.
https://api.apify.com/v2/actors/kumo-data-tools~google-sheets-safe-upsert/runs?token=<YOUR_API_TOKEN>Note: By adding the method=POST query parameter, this API endpoint can be called using a GET request and thus used in third-party webhooks. Please refer to our Run Actor API documentation.
https://api.apify.com/v2/actors/kumo-data-tools~google-sheets-safe-upsert/run-sync-get-dataset-items?token=<YOUR_API_TOKEN>Note: This endpoint supports both POST and GET request methods. However, only the POST method allows you to pass input data. For more information, please refer to our Run Actor synchronously and get dataset items API documentation.
https://api.apify.com/v2/actors/kumo-data-tools~google-sheets-safe-upsert?token=<YOUR_API_TOKEN>For more information, please refer to our Get Actor API documentation.
Actors can be used to scrape web pages, extract data, or automate browser tasks. Use the Google Sheets Safe Upsert (Validated Diff) API programmatically via the Apify API.
You can choose from:
You can start Google Sheets Safe Upsert (Validated Diff) with the Apify API by sending an HTTP POST request to the Run Actorendpoint. An Actor’s input and its content type can be passed as a payload of the POST request, and additional options can be specified using URL query parameters. The Google Sheets Safe Upsert (Validated Diff) is identified within the API by its ID, which is the creator’s username and the name of the Actor.
When the Google Sheets Safe Upsert (Validated Diff) run finishes you can list the data from its default dataset(storage) via the API or you can preview the data directly on Apify Console.