Skip to main content
POST
/
webhooks
/
register
curl --request POST \
  --url https://api.simplified-webhooks.com/webhooks/register \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "baseId": "appkGlXEiufQLn1Qd",
  "tableId": "tblMHdKX6vN1Eci9x",
  "event": "record_update",
  "columnId": [
    "fldAqLqTAgpBIv6HF",
    "fldAnotherColumnId"
  ],
  "webhookUrl": "https://hook.eu2.make.com/your-unique-hook-id"
}
'
{
  "message": "Successfully registered new webhook for event: record_create.",
  "webhookId": "20c775ff-666c-42d7-b4db-26e4af4e43c7"
}

Authorizations

​
Authorization
string
header
required

API key for authentication.

Body

application/json

Webhook registration details

​
baseId
string
required

The ID of the base.

Example:

"appkGlXEiufQLn1Qd"

​
event
enum<string>
required

The type of event to subscribe to.

Available options:
record_update,
record_create,
record_delete,
table_create,
table_update,
table_delete,
column_create,
column_update,
column_delete
​
webhookUrl
string<uri>
required

The URL to which the webhook notifications will be sent.

Example:

"https://hook.eu2.make.com/your-unique-hook-id"

​
tableId
string

Record events: Required. Single table ID. table_create: Omit. Watches entire base for new tables. table_update / table_delete / column_create / column_update / column_delete: Optional. Pass as array of table IDs to watch specific tables, or omit/null to watch all tables.

Example:

"tblMHdKX6vN1Eci9x"

​
columnId
string[]

An array of column IDs to watch for updates. Required for record_update, must be empty for all other events.

Response

Webhook registered successfully.

​
message
string
Example:

"Successfully registered new webhook for event: record_create."

​
webhookId
string<uuid>
Example:

"20c775ff-666c-42d7-b4db-26e4af4e43c7"