Update Webhook
surveymonkey.update_webhook
ActionBusiness appsconnection required
Calls the SurveyMonkey API with the connection's credentials.
Change a webhook's name, target URL, event or object filter without recreating the subscription.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- OAuth 2.0
- Providers
- SurveyMonkey
- Secret shape
- the OAuth2 access token, or {"access_token": "…"}
- Config it needs
- base_url, datacenter
- Resolved by
- config.connection_id, else node.connection_id
Configuration
8 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
webhook_id The webhook id to change. | string | Yes | — | — | — |
name The new webhook name. | string | No | — | — | — |
subscription_url The new URL SurveyMonkey posts each event to. | string | No | — | url format | — |
event_type The event this webhook should listen to instead; SurveyMonkey does not accept the app_installed and app_uninstalled events on an update. | string | No | — | one of "survey_created", "response_completed", "response_updated", "response_disqualified", "response_created", "response_deleted", "response_overquota", "collector_created", "collector_updated", "collector_deleted", "survey_updated", "survey_deleted" | — |
object_type The kind of object to filter events by. | string | No | — | one of "survey", "collector", "app" | — |
object_ids The ids of the objects to watch, comma-separated; required whenever object_type is set. | string | Conditional | — | only with object_type | — |
authorization A new Authorization header value for the callbacks; never returned. | string | No | — | — | — |
verify_ssl Whether SurveyMonkey verifies the subscription URL's TLS certificate. | boolean | No | — | — | — |
- At least one of name, subscription_url, event_type, object_type, authorization, verify_ssl must be set.
Output
One shape.
result
| Field | Type | Example |
|---|---|---|
id The webhook id. | string | — |
name The webhook name. | string | — |
event_type The event this webhook is subscribed to. | string | — |
object_type Which kind of object the webhook filters on. | string | — |
object_ids The ids of the objects the webhook filters on. | array | — |
subscription_url The URL SurveyMonkey posts each event to. | string | — |
href The webhook's own API URL. | string | — |
authorization_set True when the webhook carries an Authorization header value; the value itself is never returned. | boolean | — |
{
"authorization_set": false,
"event_type": "",
"href": "",
"id": "",
"name": "",
"object_ids": [],
"object_type": "",
"subscription_url": ""
}Notes
- SurveyMonkey refuses the app_installed and app_uninstalled events on an update; delete the webhook and create it again instead.
See Update Webhook run in a workflow.
In a technical demo we add the SurveyMonkey connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.