Update Webhook

Request

PUT /v2/webhooks/10 HTTP/1.1
Authorization: Bearer oauth_token
correlation-id: CID
Content-Type: application/json; charset=UTF-8

{
  "url" : "https:\\/\\/example.com/helpscout",
  "events" : [ "convo.assigned" ],
  "secret" : "mZ9XbGHodX",
  "payloadVersion" : "V2",
  "label" : "cool webhook"
}

Path Parameters

/v2/webhooks/{webHookId}

Request fields

Path Type Required Description
url String Y URL that will be called when of the events occurs
events Array Y List of defined events, one of:
convo.agent.reply.created
convo.assigned
convo.created
convo.customer.reply.created
convo.deleted
convo.merged
convo.moved
convo.note.created
convo.status
convo.tags
customer.created
customer.updated
satisfaction.ratings
notification Boolean N Notification web hooks only send URI of the changed resource, not the payload body.
label String N Label associated with this WebHook for better clarity.
payloadVersion String N Version of the payload delivered to the url, one of
V1
V2
V1 is modelled after Mailbox API 1.0 and should not be used, because it will be phased out eventually.
V2 is modelled after Mailbox API 2.0 and it’s the preferred version. The default version (used when the field is omitted in the request) is V1 for the time being in order not be break the API by adding this new field.
secret String Y A randomly-generated (by you) string of 40 characters or less used to create signatures for each webhook method.
Help Scout uses this secret key to generate a signature for each webhook message.
When the message is received at your callback URL, you can calculate a signature and compare to the one Help Scout sends.
If the signatures match, you know it’s from Help Scout.

Response

HTTP/1.1 204 No Content
Keep-Alive: timeout=60
Connection: keep-alive