Web API

Press shift + S to search API reference.

Webhooks

Refresh a webhook

posthttps://api.airtable.com/v0/bases/{baseId}/webhooks/{webhookId}/refresh

Extend the life of a webhook. The new expiration time will be 7 days after the refresh time.

Note that this endpoint only applies to active webhooks with an expiration time.

Creator level permissions are required in order to refresh a webhook.

Requirements

AuthenticationPersonal access token, OAuth integration
Scopewebhook:manage
User role

Base creator

Billing plansAll plans

Path parameters

baseId
string
webhookId
string

Response format

expirationTime
string | null

The new time when the webhook will expire and be disabled in the ISO format.

Request (example)
Copy
$
curl -X POST "https://api.airtable.com/v0/bases/{baseId}/webhooks/{webhookId}/refresh" \
-H "Authorization: Bearer YOUR_TOKEN"
200 – Response (example)
{
"expirationTime": "2023-01-30T00:00:00.000Z"
}