Incoming Webhook

Trigger a workflow with an incoming webhook

How to Trigger Your Workflow with an Incoming Webhook

1. Create an app with one JSON input

To trigger a workflow with an incoming webhook, first, you need to make sure that your application has one JSON input value:

2. Publish your workflow

Next, publish your workflow by clicking Publish App in the top right hand corner of the App Studio.

3. Configure the Webhook URL

Now, configure your Webhook URL with your App UUID and API Key:

curl --request POST \
     --url 'https://app.airops.com/public_api/airops_apps/YOUR_APP_UUID/webhook_async_execute?auth_token=YOUR_API_KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "custom_parameter": "Custom Value"
}
'

You can now test your API by running the call in Postman or in your terminal. You should see a 200 response, which you can then validate in the application's "History" tab.

Once you have confirmed the application ran successfully, you can copy and paste the resulting Webhook URL to your external service. The URL will look something like this:

https://app.airops.com/public_api/airops_apps/a3cb8474-9ec1-4052-8c54-7cbcb7a4c846/webhook_async_execute?auth_token=G5R-eeqPiz14pjFJVqhrJxAUHTprHUtUQRsdISaThQulp4FO8eBmnNpA8k84