Checking authentication...

Hooks

Manage webhooks (hooks) on Podio objects — list, create, delete, and verify

5 tools

Get Hooks

Read Idempotent

POST /v1/tools/podio/getHooks

List all hooks (webhooks) on a Podio object. Returns hook_id, status (active/inactive), type (event name), and URL for each hook. Use ref_type "app" with an app_id to see hooks on an app. Common ref_types: "app", "space". Use this to find hook_ids for deleteHook or verification operations.

Parameters

Name	Type	Required	Description
`ref_type`	string	required	The type of object to get hooks for. Common values: "app" (app-level hooks), "space" (workspace-level hooks).
`ref_id`	number	required	The ID of the object (e.g. app_id for ref_type "app", space_id for ref_type "space").

Request

curl -X POST https://api.syncello.io/v1/tools/podio/getHooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "ref_type": "example",
  "ref_id": "123"
}'

Response

[
  {
    "hook_id": 48291053,
    "status": "active",
    "type": "item.create",
    "url": "https://webhooks.example.com/podio/deals",
    "created_by": {
      "type": "user",
      "id": 1122334
    },
    "created_on": "2026-07-01 14:38:00"
  }
]

Try It

Try it

Create Hook

Write

POST /v1/tools/podio/createHook

Create a hook (webhook) on a Podio object. The hook is created in INACTIVE state and must be verified before it receives events. After creation, call podio_requestHookVerification to start verification, then podio_validateHookVerification with the code received at the webhook URL. Common event types for apps: "item.create", "item.update", "item.delete", "comment.create", "comment.delete", "file.change". Common event types for spaces: "app.create", "app.update", "app.delete", "member_add", "member_remove".

Parameters

Name	Type	Required	Description
`ref_type`	string	required	The type of object to hook. Common values: "app" (app-level events), "space" (workspace-level events).
`ref_id`	number	required	The ID of the object (e.g. app_id for ref_type "app", space_id for ref_type "space").
`url`	string	required	The webhook URL that will receive event payloads (must be a publicly accessible endpoint).
`type`	string	required	The event type to listen for. App events: "item.create", "item.update", "item.delete", "comment.create", "comment.delete", "file.change". Space events: "app.create", "app.update", "app.delete", "member_add", "member_remove".

Request

curl -X POST https://api.syncello.io/v1/tools/podio/createHook \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "ref_type": "example",
  "ref_id": "123",
  "url": "example",
  "type": "example"
}'

Response

{
  "hook_id": 48291053,
  "note": "Hook created but inactive. Use podio_requestHookVerification to start verification."
}

Try It

Try it

Delete Hook

Destructive

POST /v1/tools/podio/deleteHook

Permanently delete a Podio hook (webhook). The hook will immediately stop receiving events. This action cannot be undone. Use podio_getHooks first to find the hook_id.

Parameters

Name	Type	Required	Description
`hook_id`	number	required	The hook ID to delete (from getHooks).

Request

curl -X POST https://api.syncello.io/v1/tools/podio/deleteHook \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "hook_id": "123"
}'

Response

{
  "note": "Hook deleted successfully."
}

Try It

Try it

Request Hook Verification

Write

POST /v1/tools/podio/requestHookVerification

Request verification for a Podio hook. This is step 1 of hook activation: Podio sends a request to the hook URL with "_type" set to "hook.verify" and a verification code. Step 2 is to call podio_validateHookVerification with that code to activate the hook. The webhook endpoint must capture and store the verification code.

Parameters

Name	Type	Required	Description
`hook_id`	number	required	The hook ID to verify (from createHook or getHooks). Must be in inactive state.

Request

curl -X POST https://api.syncello.io/v1/tools/podio/requestHookVerification \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "hook_id": "123"
}'

Response

{
  "note": "Verification request sent to hook URL. Use podio_validateHookVerification with the received code."
}

Try It

Try it

Validate Hook Verification

Write

POST /v1/tools/podio/validateHookVerification

Activate a Podio hook by submitting the verification code that was sent to the hook URL. This is step 2 of hook activation (after podio_requestHookVerification). On success, the hook becomes active and starts receiving events.

Parameters

Name	Type	Required	Description
`hook_id`	number	required	The hook ID to validate (from createHook or getHooks).
`code`	string	required	The verification code that was sent to the hook URL by requestHookVerification.

Request

curl -X POST https://api.syncello.io/v1/tools/podio/validateHookVerification \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "hook_id": "123",
  "code": "example"
}'

Response

{
  "note": "Hook verified and now active!"
}