Activepieces guide

Add a Verifagent heartbeat to an Activepieces flow

Activepieces flows fail quietly when connections expire or a piece errors. A final HTTP piece proves a successful end-to-end run.

Before you start

Create a monitor with your workflow’s real frequency, then copy its URL from the dashboard. Its token is secret: do not publish it.

Module to use : HTTP · Send Request. Place it after the last useful action on the success path.

Create one monitor per flow. Copy the ping URL from Verifagent.

https://verifagent.com/api/ping/your-ping-token

Open the flow builder. After the last business piece, add the HTTP piece and choose Send Request (naming may vary slightly by version).

Method GET, URL = your ping URL. Leave headers empty unless you proxy through something else.

GET https://verifagent.com/api/ping/your-ping-token

Use Test flow / Run. Expect HTTP 200 and {"ok":true}, then publish so the schedule keeps sending heartbeats.

{"ok":true}

Keep the HTTP piece on the success branch only. Align period with the flow trigger; set grace above typical piece latency.

The base URL is enough for a heartbeat. Variants enrich history if your platform has several branches.

GET https://YOUR_PING_URL

POST https://YOUR_PING_URL/success

POST https://YOUR_PING_URL/fail?msg=Error

After a successful test run, the monitor is Up. Pause the flow: Verifagent should open an incident once period + grace elapse.

Expected response: 200 {"ok":true}. The monitor moves from Pending to Up.