Reference

Token format

The shape of a Willo agent token and webhook token, the scopes, the expiry choices and the pattern secret scanners match.

Generated from Willo's codeOpen in ClaudeOpen in ChatGPT
On this page

Willo issues two kinds of token. Both are shown once, stored only as a hash, and can be revoked. See Agent tokens for how to create and manage one.

Format

willo_<prefix>_<public_id>_<secret><check>
PartWhat it is
prefixThree letters naming the kind of token.
public_id16 lowercase letters and digits. Not secret: it is what the dashboard and logs show.
secret52 lowercase letters and digits.
check6 hex characters, a checksum, so a mistyped token is refused at once and a scanner can tell a real token from a look-alike.

Prefixes

PrefixWhat it is
willo_agt_Agent token: the bearer an outside AI agent sends to Willo's MCP server.
willo_whk_Webhook token: the secret part of an Agent Program's webhook URL.

Agent tokens

PropertyValue
Scopesact (read + act), read
Expiry choices30 days, 90 days, 365 days
Default expiry90 days
Live tokens per business20
Label length60 characters

Secret scanning pattern

The exact shape of an agent token, as a regular expression. Use it in your own secret scanner.

^willo_agt_([a-z0-9]{16})_([a-z0-9]{52})([0-9a-f]{6})$