Provisioning users
A provisioned user is a person your platform can build orders for. You provide a name and a phone; the person proves the phone when they open the handoff link.
Create a user
POST /v1/users
{
"firstName": "Dana",
"lastName": "Whitfield",
"phone": "+19165550142"
}
→ 201
{
"id": "usr_4b8e",
"status": "provisioned",
"session": { "scope": "build", "expiresIn": 3600 }
}
The session is build-only. It can build a cart and read state, and it can never add a card, confirm, or spend.
Fields
| Field | Notes |
|---|---|
firstName | Shown to the person on the consent screen. |
lastName | Shown to the person on the consent screen. |
phone | E.164, digits only (+19165550142). No verified phone up front; the person verifies it on the link. |
Reconciliation
If a provisioned user later signs up to Layout on their own with the same number, the two are reconciled — their order history, saved card, and taste profile carry across. You never see a user's own orders, an order through another partner, or their card.
Provisioning mints nothing that can spend. The person adds a card and confirms on the Layout-hosted link.