Skip to main content
GET
/
bases
/
{databaseId}
/
webhooks
List webhooks
curl --request GET \
  --url https://tables.fillout.com/api/v1/bases/{databaseId}/webhooks \
  --header 'Authorization: Bearer <token>'
{
  "webhooks": [
    {
      "id": 123,
      "url": "<string>",
      "events": [
        "record.created"
      ],
      "active": true,
      "tableIds": [
        "<string>"
      ]
    }
  ]
}
Returns all webhook subscriptions configured for the specified database.

Example Request

curl "https://tables.fillout.com/api/v1/bases/{databaseId}/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "webhooks": [
    {
      "id": 123,
      "url": "https://your-server.com/webhooks/fillout",
      "events": ["record.created", "record.updated", "record.deleted"],
      "tableIds": null,
      "active": true
    },
    {
      "id": 124,
      "url": "https://another-service.com/webhook",
      "events": ["table.created", "field.created"],
      "tableIds": ["tbl_abc123"],
      "active": true
    }
  ]
}

Response Fields

FieldTypeDescription
idnumberUnique webhook ID
urlstringThe webhook endpoint URL
eventsstring[]Array of subscribed event types
tableIdsstring[] | nullTable filter (null means all tables)
activebooleanWhether the webhook is active

Authorizations

Authorization
string
header
required

Enter your Fillout API key. Format: Bearer <api_key>

Path Parameters

databaseId
string
required

The unique identifier of the database

Response

List of webhooks

webhooks
object[]