> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentlinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# linktrail receive

> Use a signed event notification to trigger authenticated pull.

```bash theme={null}
linktrail receive --body delivery.json --headers headers.json
```

## Behavior and output

Requires LINKTRAIL\_WEBHOOK\_SECRET and saved workspace identity. Verifies raw body, HMAC and a 300-second timestamp tolerance, then pulls cloud feeds with the API credential. Notification bytes never become observations. The current receiver accepts per-event identity only; digest payloads have no matching feed/id/sequence and are refused.

## Arguments

\--body RAW\_BODY\_FILE and --headers HEADERS\_JSON\_FILE required.

## Exit status

0 on success; 2 on usage, configuration, input or request failure.

Read [configuration and file ownership](/reference/local/configuration) before automating this command. Read [local file contracts](/reference/local/artifacts) for artifact fields. Browse the [local command index](/reference/local/index) for related commands.

<Note>Reference follows the current development CLI and HTTP contracts. Hosted availability depends on the selected environment. See [capability status](/capability-status).</Note>