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.

Image Placeholder

In the settings area, select the Webhooks subsection from the left navigation pane. Any existing webhooks will be listed here.

Image Placeholder

Managing existing webhooks

For each existing webhook, you can click the three dots to the right to access additional options.

Image Placeholder

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).

Image Placeholder

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.

Image Placeholder

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.

Image Placeholder

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:

For more information, see: Managing Your API Keys