← Spec Hub | Category: Developer APIs
Technical guide for receiving and processing automated Airtable ➔ Supabase Webhook Pipeline Specification event notifications. Follow these security guidelines to prevent unauthorized webhook calls.
Supported Events: resource.created resource.updated resource.deleted event.triggered
Security validation specs for Airtable ➔ Supabase Webhook Pipeline Specification endpoints:
X-Webhook-Signature-256: sha256=4268f3d1f5e521d2a382e13c8f9988fe
const crypto = require('crypto');
const expected = crypto.createHmac('sha256', secret).update(rawBody).digest('hex');
const isValid = crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
import hmac, hashlib
expected = hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
is_valid = hmac.compare_digest(expected, incoming_sig)
{
"id": "evt_airtable-to-supabase.html_91440",
"event": "resource.created",
"created_at": 1789764045,
"data": {
"resource_id": "res_908",
"status": "active"
}
}
curl -X POST https://your-domain.com/webhook/airtable-to-supabase.html \
-H "Content-Type: application/json" \
-H "X-Webhook-Signature-256: sha256=4268f3d1f5e521d2a382e13c8f9988fe" \
-d '{"id": "evt_airtable-to-supabase.html_91440", "event": "resource.created", "created_at": 1789764045, "data": {"resource_id": "res_908", "status": "active"}}'
| Status Code | Status Meaning | Integration Action |
|---|---|---|
200 OK | Success | Event payload validated and queued. |
400 Bad Request | Malformed Payload | Check payload structure and JSON formatting. |
401 Unauthorized | Signature Mismatch | Verify secret key and digest computation. |
500 Error | Server Error | Triggers provider automated retry backoff. |
Always process incoming events asynchronously using a message queue. Never perform long-running DB queries or external API calls synchronously within the HTTP response handler.
Store processed event IDs in an atomic storage like Redis with a set expiration. If an incoming ID exists, acknowledge with 200 OK immediately without re-triggering logic.
Compute the HMAC SHA-256 hash on the raw request body using your shared secret and compare it against the incoming signature header using time-constant comparison.
Failed deliveries (non-2xx responses) trigger an exponential backoff retry schedule over a period ranging from 24 to 72 hours.