Webhooks

Webhooks let you integrate Sempleo with any system that can send or receive HTTP requests.

Inbound Webhooks

Receive data from external systems to trigger agent runs or feed data into Sempleo.

Setup

1. Go to Settings → Integrations
2. Find Webhooks in the catalog
3. Click Connect and configure your webhook URL

Webhook URL

Sempleo generates a unique webhook URL for your workspace:

https://api.sempleo.ai/api/v1/webhooks/{workspace-id}/{webhook-id}

Payload Format

Send a JSON payload to trigger an agent:

{
  "agentId": "agent-install-id",
  "prompt": "Process this incoming data",
  "context": {
    "source": "external-system",
    "data": { ... }
  }
}

Outbound Webhooks

Configure agents to send results to external endpoints.

Setup

1. Open agent settings
2. Go to the Output tab
3. Add a webhook output destination
4. Enter your endpoint URL
5. Optionally configure headers (for authentication)

Payload Sent

{
  "agentId": "agent-install-id",
  "agentName": "Research Agent",
  "runId": "run-uuid",
  "result": "The agent's response text...",
  "metadata": {
    "timestamp": "2026-04-14T10:30:00Z",
    "creditsUsed": 50,
    "model": "standard"
  }
}

Security

• Webhook URLs include a unique, unguessable identifier
• For outbound webhooks, you can add custom headers (e.g., Authorization: Bearer your-token)
• All webhook traffic uses HTTPS
• Inbound webhooks validate JSON content type

Troubleshooting