Webhooks

The Webhooks tab allows you to configure HTTP callbacks that notify your systems when events occur. Use webhooks to integrate Mobilerun with your existing infrastructure and automation pipelines.

What is a Webhook?

A webhook is an HTTP request that Mobilerun sends to your server when a specific event happens. Instead of polling the API to check for updates, your server receives notifications automatically in real-time. When an event occurs:

Mobilerun detects the event (e.g., a task completes)
Mobilerun sends an HTTP POST request to your configured URL
Your server receives the payload and processes it

This enables real-time integrations without constant API polling.

Event Triggers

Configure webhooks to fire on any of these task events:

Event	Description
created	A new task has been submitted
running	A task has started executing on a device
paused	A task execution has been paused
completed	A task finished successfully
failed	A task encountered an error and stopped
cancelled	A task was manually cancelled

You can subscribe to multiple events with a single webhook, or create separate webhooks for different event types.

Creating a Webhook

To add a new webhook:

Click Add Webhook
Enter your endpoint URL (must be HTTPS)
Select which events should trigger the webhook
Save the webhook

Your endpoint will start receiving events immediately.

Webhook Payload

When an event fires, Mobilerun sends a POST request with a JSON payload containing:

{
  "event": "completed",
  "task": {
    "id": "task_abc123",
    "task": "Open Settings and enable dark mode",
    "status": "completed",
    "deviceId": "device_xyz",
    "createdAt": "2025-01-08T10:30:00Z",
    "finishedAt": "2025-01-08T10:32:45Z",
    "succeeded": true,
    "output": {}
  }
}

Managing Webhooks

Your webhook list displays:

Field	Description
URL	The endpoint receiving events
Events	Which events trigger this webhook
State	Active, disabled, or deleted
Created	When the webhook was configured

Webhook States

State	Description
Active	Webhook is receiving events normally
Disabled	Webhook is paused and not receiving events
Deleted	Webhook has been removed

Edit Webhooks

Update a webhook to change:

The events it subscribes to
Its active/disabled state

Delete Webhooks

Remove webhooks that are no longer needed. Deleted webhooks stop receiving events immediately.

Use Cases

CI/CD Integration

Trigger deployment pipelines when test tasks complete successfully.

Alerting

Send notifications to Slack or email when tasks fail.

Data Processing

Store task results in your database automatically.

Workflow Automation

Chain tasks together by starting new tasks when others complete.

Integration Examples

Zapier

Connect Mobilerun to thousands of apps using Zapier. Trigger Zaps when tasks complete and automate downstream workflows.

n8n

Use webhooks to integrate with n8n workflows for custom automation logic.

Custom Endpoints

Build your own webhook receiver to process events however you need:

from flask import Flask, request

app = Flask(__name__)

@app.route("/webhook", methods=["POST"])
def handle_webhook():
    payload = request.json
    event = payload["event"]
    task = payload["task"]
    
    if event == "completed" and task["succeeded"]:
        # Handle successful task
        pass
    elif event == "failed":
        # Handle failed task
        pass
    
    return "", 200

For a complete, runnable receiver with HMAC verification, replay protection, and secure file downloads, see the Python webhook receiver example.

Best Practices

Practice	Description
Use HTTPS	Always use secure endpoints for webhook URLs
Respond quickly	Return a 2xx status code promptly to acknowledge receipt
Handle duplicates	Design your handler to be idempotent in case of retries
Verify payloads	Validate incoming data before processing

Introduction

Concepts

Guides

Dashboard

Agent Skills

Integrations

What is a Webhook?

Event Triggers

Creating a Webhook

Webhook Payload

Managing Webhooks

Webhook States

Edit Webhooks

Delete Webhooks

Use Cases

CI/CD Integration

Alerting

Data Processing

Workflow Automation

Integration Examples

Zapier

n8n

Custom Endpoints

Best Practices

​What is a Webhook?

​Event Triggers

​Creating a Webhook

​Webhook Payload

​Managing Webhooks

​Webhook States

​Edit Webhooks

​Delete Webhooks

​Use Cases

CI/CD Integration

Alerting

Data Processing

Workflow Automation

​Integration Examples

​Zapier

​n8n

​Custom Endpoints

​Best Practices

What is a Webhook?

Event Triggers

Creating a Webhook

Webhook Payload

Managing Webhooks

Webhook States

Edit Webhooks

Delete Webhooks

Use Cases

Integration Examples

Zapier

n8n

Custom Endpoints

Best Practices