Black Friday Deal—Save up to 40% on an unlimited agents plan at $75.  

Webhook Payloads, Headers, and Event

Updated on : November 11, 2022

Webhook modules and events

A webhook is triggered when an action is performed on a module in the BoldDesk. Each module has a unique set of events. When creating a webhook, you should select the module and events.

The modules and events that are supported are listed in the following table.

Modules

Events

Triggered when

Ticket

Created

A new ticket is created.

Property Updated

1.       Any fields are changed in existing ticket.

2.       A ticket is marked as spam.

3.       A ticket is removed from spam.

4.       A ticket is deleted softly.

5.       A ticket is restored.

Reply Created

A new reply is created.

Notes Created

A new note is added.

Permanently Deleted

A ticket is deleted permanently.

Satisfaction Feedback

A feedback is added

Contact

Created

A new contact is created.

Updated

1.       Any fields are changed in existing contact.

2.       A contact is blocked.

3.       A contact is unblocked.

4.       A contact is deleted softly.

5.       A contact is restored.

Permanently Deleted

A contact is deleted permanently.

Contact Group

Created

A new contact group is created.

Updated

Any fields are changed in existing contact group.

Deleted

A contact group is deleted.

Worklog

Created

A new worklog is created.

Updated

Any fields are changed in existing worklog.

Deleted

A worklog is deleted.

 

Webhook headers

System and custom headers are sent along with webhook data to the specified webhook endpoints. When creating a webhook, you can include your own custom headers.

System headers

By default, the headers listed below are sent with each webhook request.

Header Keys Header Values
Host <webhook-endpoint>
AcceptEncoding gzip;q=1.0,deflate;q=0.6,identity;q=0.3
Accept-Charset utf-8, iso-8859-1; q=0.5, *; q=0.1
Content-Type application/json; charset=utf-8
User-Agent BoldDesk
Authorization Basic cUFEU0ZHSEpLSg==
x-signature v7czZPsztnM910sLP5yT6OO+mVEpVktBE5zLdzkZ+rU=
Event-Type <event-name>
Event-Time 05/17/2021 11:30:37

Custom headers

Custom headers are used to send additional information to the destination URL. Follow the given steps to add a custom header:

  1. Enter the key and value of the header and click Addto add it in the header record.
  2. To remove the header, click the Delete.
Add Option
Add Option

 

Webhook payload

The data from the selected module are sent as a webhook payload. Two ways to send the webhook payload are:

  • Default Payload
  • Advanced Payload

Default Payload

This option automatically sends a default payload template to a webhook, which varies depending on the events.

You can send all of them or only the required data by selecting the following options:

  • Include all fields in the payload (Optional)

When this option is enabled, all data are sent in the payload.

  • Payload (Required)

The selected data are only sent in the payload.

Default Payload
Default Payload

Advanced Payload

This option allows you to customize and configure a specific payload to a webhook endpoint.

Advanced Payload
Advanced Payload

Sample payload

{
"priorityId": 2,
"requesterEmailId": "john@example.com",
"brandId": 1,
"isVisibleInCustomerPortal": {{ticket.IsVisibleInCustomerPortal}},
"subject": {{ticket.Subject}},
"description": {{ticket.Description}},
"tag": "created-by-webhook"
}

Was this article helpful?

    Live Chat Icon