Nest Engineering Docs
Webhooks

Overview

Python 3.13 webhook ingress and Cloud Tasks dispatcher

Webhooks is a public Python 3.13 FastAPI service that receives inbound webhook payloads, validates them, and schedules Cloud Tasks for downstream processing. It supports partner integrations and Bubble-triggered sync events.

Service profile

FieldValue
Codeservices/webhooks/
Packagewebhooks
RuntimePython 3.13 (FastAPI)
StatusActive
Primary ownerAkansh Divker
Secondary ownerJohn Thomas
Primary consumersPartners, Bubble app
AuthX-API-Key header

Responsibilities

  • Accept inbound webhook payloads over HTTP.
  • Validate headers, payload size, and request structure.
  • Enqueue Cloud Tasks for the Handler service.

Non-goals

  • Direct data ingestion into Spanner or other stores.
  • Business logic beyond lightweight validation and task scheduling.

Dependencies

  • Upstream: Partner systems, Bubble triggers.
  • Downstream: Cloud Tasks; Handler service (internal).
  • External: Google Secret Manager; Sentry.

Last updated on

Ownership

Ownership and support model for Partner Credentials

Architecture

System design and data flow for Webhooks