Webhooks

Webhooks are custom HTTP callbacks for events that happen in awork.

Main benefits and use cases

• Notify external tools about changes, for example when a task is created or a project status is updated
• Call other APIs for specific events (for example when a new task or time entry is created)
• Create automations or synchronizations so you and your team can share data and collaborate across different tools
• Develop custom integrations using webhooks and our API

How to set up a new webhook

You'll need a webhook endpoint first so you can receive and verify the webhook request.

Create a webhook endpoint

• Use a tool (for example Requestbin) to create a webhook endpoint
• Copy the endpoint's URL

Add the webhook in awork

• Go to Settings (gear icon at the bottom left of the main menu) > Integrations
• Open the Integration library
• Under the API connectors category, select Webhooks
• Click Set up integration

Enter details, select an event, and test

• Enter the required information like name and URL
• Enable authentication if needed
• In the Triggering event(s) section, click Add to select the awork event that should trigger your webhook
• Disable Only events from first-level properties if needed: By default, only first-level events are sent for task, project, and time entry properties. Changes to nested properties (like tags) are ignored. This can significantly reduce the number of webhook requests.
• Test the webhook and check the received request in your endpoint tool
• Click Save

Manage existing webhooks

All webhooks are displayed on the integrations page under Already integrated.

From there, you can:

• Edit a webhook
• Pause a webhook
• Check the logs of a webhook
• Delete a webhook

Best practices and resources

Check out these additional resources:

• Developer Resources at developers.awork.com
• Ask API questions in our Developer Forum

FAQ

What are webhooks in awork?

Webhooks notify external tools about changes in awork, for example when a task is created or a project status is updated.

What can I create with webhooks?

You can call other APIs for specific events (for example when a new task or time entry is created) to build automations or synchronizations.

Where do I configure webhooks in awork?

Go to Settings > Integrations, open the Integration library, and select Webhooks.

Where can I see and manage existing webhooks?

You'll find them under Already integrated on the integrations page. From there, you can edit, pause, delete webhooks or check logs.

Can I use something else instead of webhooks?

Yes. Alternatively, you can use Zapier. With it, you can integrate tools without writing code yourself.