---
title: "Receive a signed external-agent wake-up event"
method: POST
path: "externalAgentWakeUp"
---

# Receive a signed external-agent wake-up event

`POST externalAgentWakeUp` (webhook)

Provider-neutral reference-only HTTPS POST from Loppee. The receiver verifies the HMAC and timestamp, deduplicates by event_id or X-Request-ID, and durably accepts the event. For live workflow events it then uses its separate scoped Loppee API/MCP key to fetch the referenced resource. agent.webhook.test is receipt-only and has no fetchable resource. Hermes Generic V2 and any capable customer-operated receiver can implement this wire contract.

## Headers

- `X-Webhook-Timestamp` string, required
- `X-Request-ID` string, required

## Payload

- ExternalAgentWebhookPayload
  - `schema_version` 'external-agent-webhook.v1', required
  - `event_id` string, required
  - `event_type` 'business.message.replied' | 'customer.message.created' | 'admin.verification_submission.created' | 'agent.webhook.test', required
  - `occurred_at` string, date-time, required
  - `recipient` object, required
    - `scope_kind` 'consumer' | 'management' | 'team', required
    - `account_id` string, required
    - `business_id` string, nullable, required
  - `resource` object, required
    - `kind` string, required
    - `id` string, required
    - `conversation_id` string, nullable, required

## Acknowledgement `200`

Event accepted.

## Other responses

- `204`: Event accepted with no response body.
- `default`: Non-2xx responses may be retried according to the durable delivery policy. Redirects are not followed.

---

[API](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents.md) · [All operations](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/revisions/37285f7cddcd?raw)