Within Teamwork Spaces, you can
use webhooks to
interact
with your data, build integrations, and
generate reports.
Webhooks allow trigger actions
to prompt secondary
actions to
be
performed. When
an event is triggered, we will
send a HTTP POST request to the URL
you have provided.
You can create and manage
your webhooks
via your site settings in your
Teamwork
Spaces account. Click your profile
icon in
the top right of your site and select Settings from the dropdown menu.
Note: Only
administrators can access the Webhooks
subsection of the site settings.
In the settings area, select the
Webhooks subsection from the left navigation
pane. Any existing webhooks will be listed
here.
Managing existing
webhooks
For each existing webhook, you
can click the three dots to the right to
access additional options.
Clicking the webhook will open a
details view detailing the webhook and any
existing requests. You can also deactivate or
delete the webhook from this view via the
options button (three dots).
For previous requests, you can click the arrow to the right to expand the request details. You will also have a Redeliver option for failed requests.
Creating a webhook
Click the Add Webhook button
in the top right of the Webhooks area to
create a new
webhook.
When creating a webhook, you will need to
add your URL and specify which events to
send. You can select Every
event or customize specific
events to include.
An additional option is to add a
token to verify the request:
- Teamwork will use this token to generate a
checksum which will be sent with each
request in the Signature header. This
allows you to verify that the request came
from Teamwork Spaces and is
unaltered.
You can access the Teamwork Spaces API
documentation via the following
links: