Skip to main content
POST
Activate a wallet from its on-chain allowances
Requires scope: manage:accounts — see Required scopes. Activates a self-custody account wallet by reading the allowances it has already granted on-chain, instead of going through the permit flow. This is the route for a smart-contract wallet — a Safe, for example. A contract wallet is controlled by its owners rather than a single key, so it cannot produce the one signature a permit needs. It grants the same permission with a plain approve(spender, amount) transaction instead. The allowance is the consent: only the wallet’s controller could have granted it. So this endpoint reads public chain state and takes no request body and no proof.

What happens when you call it

1

Allowances are read synchronously

Every asset covered by a sufficient allowance is marked confirmed.
2

All assets covered → ACTIVE

The wallet is usable immediately.
3

Some assets missing → VERIFYING_ALLOWANCE

You get a verificationExpiresAt. Venly keeps re-checking until then, so granting the remaining allowances is enough — you don’t have to call again.
VERIFYING_ALLOWANCE is a waiting room, not a usable state. Every check that requires an active wallet treats it exactly like PENDING, so don’t offer the wallet to an end-user until it reads ACTIVE.If the window closes with assets still uncovered, the wallet falls back to PENDING and you start again.
Read assets[] to see exactly which allowances are still missing — allowanceSufficient is per asset. Both activation routes end in the same place: a wallet is ACTIVE once every supported asset is covered. See Permits and allowances.

Errors

The codes this endpoint can return, in addition to the standard errors. Branch on code, never the message.

Authorizations

Path Parameters

accountId
string<uuid>
required

Unique account identifier

walletId
string<uuid>
required

Unique wallet identifier

Response

Verification outcome and the wallet's resulting status

success
boolean

Indicates whether the request was successful

result
object