Webhooks

Use Webhooks to automate common workflows or build custom integrations.

Updated over a week ago

Dart can be configured to send updates to an endpoint of yours to automate some common workflows and build other custom integrations or processes.

You can get a more complete introduction to webhooks here.

Quickstart

  1. Navigate to the Webhooks page in Dart Settings and ensure the ‘Enable’ toggle is turned on

  2. Copy the ‘Webhook secret’ and set the environment variable DART_WEBHOOK_SECRET to this value, for instance with

    export DART_WEBHOOK_SECRET='dsw_...'
  3. Start running the example webhook server packaged with dart-tools, for instance with

    git clone <https://github.com/its-dart/dart-tools.git> ./dart-tools/examples/webhook_server.py
    • Example

  4. Start proxying web traffic to this local server with ngrok (or any other proxy), for instance with

    brew install ngrok/ngrok/ngrok ngrok http 5000
  5. Copy the proxy link (for ngrok, this is the first link after the word ‘Forwarding’) and paste that into the ‘Webhook target URL’ in Dart and save it

    • Example

      Here we have enabled webhooks, set the target URL to the appropriate ngrok URL, and copied the secret

  6. Create, update, or delete tasks in Dart and observe the updates coming into the example server!

    • Example

      Here, a new task has been created, the webhook was activated, and the related data have been printed by the example server

Did this answer your question?