Skip to content

Runbook - App Sandbox Activations for Mission-Critical Airtable Systems

Step-by-step guide for app sandbox activations in mission-critical Airtable systems.

Runbook for enterprise environments (large bases, heavy automations, external integrations).

0) Change Governance (Mandatory for Mission-Critical Systems)

Section titled “0) Change Governance (Mandatory for Mission-Critical Systems)”

0.1 Internal Change Request (Request & Solutions System)

Section titled “0.1 Internal Change Request (Request & Solutions System)”
  • Create an internal Request & Solutions ticket before any Sandbox activation
  • Classify the change as:
    • Special Procedure
    • Planned Production Change
    • Potential Operational Impact
  • Include in the request:
    • System name (e.g., Invercorp / Singular Agile)
    • Airtable Base/App ID
    • Organization ID
    • Scope of changes (schema, automations, interfaces, etc.)
    • Risk level (Mission-Critical System)
    • Maintenance window (date, time, timezone)
    • Rollback and validation plan
  • Explicitly state:
    • “This procedure involves App Sandbox activation, which may temporarily affect system operability and structural editing in production.”
  • Obtain internal approval from:
    • Chapter Lead / Technical Lead
    • Project Owner / Stakeholders
    • Operations (if client-facing system)

1) Pre-Activation Planning (T-14 to T-7 days)

Section titled “1) Pre-Activation Planning (T-14 to T-7 days)”
  • Create an inventory of:
    • Tables + critical linked relationships
    • Critical views (especially those used by stakeholders daily)
    • Interfaces (client-facing and internal ops)
    • Extensions (anything powering monitoring/reporting)
    • Synced tables (especially two-way)
    • Automations (grouped by internal vs external actions)
    • External integrations (APIs, n8n, Make, Zapier, custom services)
  • Identify “blast radius” components:
    • High-impact automations
    • Client-facing dashboards
    • Regulatory/financial workflows
    • Any workflows tied to external SLAs

1.2 Sandbox Activation Blockers (Must fix before you attempt)

Section titled “1.2 Sandbox Activation Blockers (Must fix before you attempt)”
  • Remove/refactor personal views referenced by:
    • Automations
    • Filters
    • Any dependency chain (this can block Sandbox enablement)
  • Identify locked/collaborative views underpinning critical filters/sorts
  • Finalize AI field configurations (no pending changes)
  • Finalize AI-linked record matching rules
  • Plan significant Gantt configuration changes outside the Sandbox period
  • Confirm base scale (rows + attachment GB)
  • Allocate extra time: Sandbox creation may take several minutes or longer for large bases
  • Select an off-peak maintenance window
  • Prepare a structured validation checklist for the post-apply phase

2) Pre-Activation Hardening (T-7 to T-1 days)

Section titled “2) Pre-Activation Hardening (T-7 to T-1 days)”

2.1 Automation Safety Strategy (Critical in Sandbox)

Section titled “2.1 Automation Safety Strategy (Critical in Sandbox)”
  • List automations with external actions (email, Slack/Teams, SMS, webhooks/APIs, scripts interacting externally, Google Workspace, Jira/Salesforce/GitHub, etc.)
  • Confirm the team understands:
    • External-facing automation actions are skipped by default in Sandbox
  • Decide how you will test:
    • Prefer “Test automation” runs
    • Only run end-to-end flows if external systems can tolerate test events

2.2 Integration Testing Plan (Sandbox is a separate base)

Section titled “2.2 Integration Testing Plan (Sandbox is a separate base)”
  • Document all integration endpoints (Production)
  • If validation against Sandbox is required:
    • Prepare separate Sandbox configs in n8n/Make/Zapier/custom backends
    • Ensure no production data is accidentally triggered
  • Confirm stakeholders understand:
    • External tools connected to Production will not automatically reference Sandbox
  • Document all two-way syncs
  • Confirm stakeholders understand:
    • Two-way sync tables are effectively static/read-only in Sandbox
  • Define what “acceptable testing” looks like without live sync behavior

2.4 Support Readiness (Enterprise without Premium Support)

Section titled “2.4 Support Readiness (Enterprise without Premium Support)”
  • Open a pre-activation Support ticket 1 day before the window
  • Include:
    • Organization ID
    • App/Base IDs
    • Approx. record counts + attachment volumes
    • Maintenance window (date, time, timezone)
    • Intended change scope
  • Define escalation wording if incident occurs:
    • Reply to the ticket with: “URGENT - Production Impact”
    • Include explicit impact (blocked workflows, client-facing disruption, external SLAs at risk)

Optional:

  • Book an Ask an Expert (AAE) session to review approach before first activation
  • Confirm maintenance window started and stakeholders notified
  • Freeze structural edits in Production during the Sandbox lifecycle
  • Confirm “known good state”:
    • No pending AI changes
    • No urgent schema changes in progress
    • No personal view dependencies remain
  • Confirm incident lead + escalation path ready (support ticket exists)
  • In Production base: Base menu -> ”+ Create sandbox”
  • Allow sufficient time for creation to complete (large bases may take minutes+)
  • Confirm Sandbox is created successfully before proceeding
  • Perform ALL configuration changes in Sandbox:
    • Schema updates (tables/fields/relationships)
    • Automations (logic, triggers, conditions, actions)
    • Interfaces
    • Extensions
  • Avoid editing production structure while Sandbox is active
  • Keep a written change log (what changed, why, who)
  • Validate views and interfaces in Sandbox
  • Validate automations:
    • Prefer “Test automation” runs
    • Confirm intended behavior without external actions firing
  • If end-to-end tests are required:
    • Carefully disable “Skip actions in sandbox” for specific automations only
    • Confirm external systems can tolerate test events

5) Apply Changes to Production (Controlled Deployment)

Section titled “5) Apply Changes to Production (Controlled Deployment)”
  • Production/Sandbox -> “Review changes”
  • Validate the change list carefully:
    • Applied items overwrite corresponding Production configuration

Batch 1: Schema

  • Apply schema changes first
  • Validate critical workflows immediately after

Batch 2: Automations

  • Apply automation changes second
  • Validate key automation runs and logs

Batch 3: Interfaces/Extensions

  • Apply interfaces and extensions last
  • Validate dashboards and client-facing views

Stop Rule:

  • If validation fails or impact is detected, halt further applies and execute incident process
  • Interfaces and client-facing dashboards
  • Critical views and filters
  • High-impact automations + logs
  • Integration points (confirm nothing unintended is firing)
  • Sync behavior (and reconcile expectations)
  • Record counts consistency where relevant
  • Confirm no new fields/options/views were added in Production during Sandbox lifecycle
  • If drift exists:
    • Reconcile before finalizing
    • Document differences
  • Confirm success criteria met
  • Communicate completion to stakeholders
  • Delete Sandbox when stable to restore normal structural editing in Production
    • Note: Sandbox copy moves to workspace trash as a separate base for reference

8) Incident Playbook (If Something Goes Wrong)

Section titled “8) Incident Playbook (If Something Goes Wrong)”
  • Immediately assess severity:
    • Production workflow blocked?
    • Client-facing processes affected?
    • External SLAs at risk?
  • Escalate via the pre-activation ticket:
    • Reply with “URGENT - Production Impact”
    • Provide concrete symptoms, timeframe, and affected components
  • Contain impact:
    • Pause further applies
    • Revert by not applying additional changes
    • Implement targeted corrective changes as a follow-up batch
  • Document root cause + preventive actions

9) Continuous Improvement (After First Activation)

Section titled “9) Continuous Improvement (After First Activation)”
  • Run a retrospective:
    • What caused delays?
    • Which validations were missing?
    • Where did users get confused?
  • Improve your checklist + templates
  • Consider Premium Support if you routinely run mission-critical windows needing faster SLA guarantees