Integromat
  • Back to website
Articles in this section
  • Custom Mailhook
  • Instant triggers (webhooks)
  1. Integromat Support
  2. Using Integromat
  3. Webhooks

Instant triggers (webhooks)

Integromat Support Team Integromat Support Team Updated January 09, 2021 17:27

Many services provide so called webhooks to deliver instant notifications whenever a certain change occurs in the service. To process these notifications, use instant triggers. These can be easily recognized by the INSTANT tag:

mceclip0.png

If the service does not provide webhooks, polling triggers have to be used instead to periodically poll the service.

Webhook's queue

All incoming webhook's data (or shortly, webhooks) are stored in the webhook's queue. To view the content of the queue:

  1. Go to the Webhooks section in the menu on the left.
    2019-11-14_13_48_45-My_Lab___Integromat.png
  2. Find the webhook you want to view the queue of.
  3. Click the button with a truck icon and the number of received webhooks:
    2019-11-14_13_51_33-Webhooks___Integromat.png
  4. The webhook's queue is displayed.
    xgY96Sc5tv.gif

The limit of stored webhooks in the queue depends on your pricing plan - see Webhook queue size in the pricing plans table. When the queue is full, all incoming webhooks over the limit will be refused. Webhooks are stored in the queue for 30 days, older webhooks are removed. The data stored in the queue is counted into your storage space limit:
2019-11-14_13_45_19-My_Lab___Integromat.png

Incoming webhook data is always stored in the queue regardless of the Data is confidential option setting. As soon as the data is processed in a scenario, it is permanently deleted from our systems.

Scheduling Instant triggers

If your scenario contains an instant trigger, you can schedule the scenario to run Immediately:

2019-11-14_11_41_00-Integration_Webhooks__Tools__HTTP___Integromat.png

In this case, your scenario will run immediately once Integromat receives new data from the service. Once the scenario executes, the total amount of pending webhooks waiting in the queue is counted and the scenario performs as many cycles as there are pending webhooks, processing one webhook per cycle.

A cycle is not the same as a scenario run! There can be more cycles within a scenario run. For more information about cycles, please refer to the Cycles documentation.
When executing scenarios with an instant trigger scheduled as Immediately, then the following exceptions apply:
  1. The interval between two executions is not subject to the Minimum interval according to the pricing plan. - i.e. once the scenario finishes its execution, the webhook's queue is checked again. If there are any pending webhooks, the scenario executes immediately again, and once again processes all the pending webhooks.
  2. The Maximum number of cycles scenario setting is ignored and set to 100 - i.e. maximum of 100 pending webhooks will be processed during a single scenario execution, one event per one cycle.

If you use any other schedule setting than Immediately, the scenario will execute at given intervals. As several webhooks can be gathered in the queue during the interval, it is recommended to set the Maximum number of cycles to a higher value than the default 1 to process more webhooks in one scenario run:

  1. Click on the cog-wheel in the bottom of your scenario to open Scenario settings.
  2. Enter the desired value (number of cycles) to the Max number of cycles field. e.g. 10.

Now, when the scenario is executed, 10 webhooks from the queue will be processed in one scenario run.

Rate limits

The current rate limit is five webhooks per second. If the limit is exceeded, 429 status code is returned.

Expiration of Inactive Webhooks

The webhook that has not been assigned to any scenario for more than 120 hours will be removed.

mceclip0.png

Error Handling

When there is an error in your scenario with an instant trigger, the scenario:

  • stops immediately - when the scenario is set to run Immediately.
  • stops after 3 unsuccessful attempts (3 errors) - when the scenario is set to run as scheduled.

If an error occurs during the scenario execution, the webhook is placed back into the queue during the instant trigger's rollback phase. In such a situation, you have the possibility to fix the scenario and rerun it again.

If there is a Webhook response module in your scenario, the error is sent to the Webhook response. The Webhook response module is always executed last (in the case where the Auto commit option in the Scenario settings is not enabled).

Custom Webhooks

You can create your own webhooks. For detailed information on creating custom webhooks, please see the Webhooks Documentation.
Was this article helpful?
9 out of 25 found this helpful
Menu
  • Features
  • Apps & Services
  • Templates
  • Pricing
  • What's new
  • Use cases
Information
  • Terms,  Privacy
  • FAQ
  • Help & Tutorials
  • Community
  • Affiliate Program
  • Blog
Developers
  • Developer Platform
Company
  • About the company
  • Join our team
  • Contact
Follow us
© 2020 Integromat by Celonis. All rights reserved. Integromat® is a registered trademark.
  • English