Recipes
API recipes (customers, tasks, actions, webhooks) and how to model a barbershop, aesthetics, clinic, restaurant and deliveries.
Updated:
API recipes
All of them use $WAGEND_KEY as in the quickstart.
Create a customer and book for them in one go
Needs customers:write and bookings:write. The phone number is the customer's unique identifier: if it already exists, the API answers 409 customer_exists.
curl -X POST https://api.fiuit.com/v1/customers \
-H "Authorization: Bearer $WAGEND_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "Marina", "phone": "+5521988887777", "locale": "pt", "tags": ["vip"],
"address": { "street": "Rua das Flores", "number": "120", "city": "Rio de Janeiro", "formatted": "Rua das Flores 120, Rio de Janeiro" } }'
curl -X POST https://api.fiuit.com/v1/bookings \
-H "Authorization: Bearer $WAGEND_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{ "service_id": "svc_corte", "start": "2026-10-15T09:45:00-03:00",
"customer": { "name": "Marina", "phone": "+5521988887777" } }'
POST /bookings does the hold and the confirmation in a single call.
Read what is due today
Needs bookings:read. GET /work-items is the same query the Today screen uses.
curl "https://api.fiuit.com/v1/work-items?view=today&limit=50" \
-H "Authorization: Bearer $WAGEND_KEY"
# Only what nobody has taken yet
curl "https://api.fiuit.com/v1/work-items?unassigned=true&limit=50" \
-H "Authorization: Bearer $WAGEND_KEY"
Each task carries its stage and its available_actions.
Assign and close a delivery with actions
Needs bookings:write. Actions are named by the business's stage configuration (with the deliveries template: atribuir, soltar, iniciar, concluir, nao_estava). Look them up in available_actions on the task.
# Assign the delivery to a courier (resource_id is the courier's resource)
curl -X POST https://api.fiuit.com/v1/bookings/$TASK_ID/actions/atribuir \
-H "Authorization: Bearer $WAGEND_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{ "data": {}, "resource_id": "'$COURIER_ID'" }'
# Close it as completed
curl -X POST https://api.fiuit.com/v1/bookings/$TASK_ID/actions/concluir \
-H "Authorization: Bearer $WAGEND_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{ "data": {} }'
If two people take the same task at once, one wins and the other gets 409 already_claimed. The "Accept delivery" action (aceitar) is for staff from the dashboard or Telegram: it takes the task with the resource of whoever runs it.
Receive webhook notifications
Register an endpoint (see Webhooks) and verify the signature before processing. Minimal Express example:
import express from 'express'
import { verifyWagend } from './verify' // the function from the Webhooks page
const app = express()
app.post('/wagend', express.raw({ type: 'application/json' }), (req, res) => {
const raw = req.body.toString('utf8')
if (!verifyWagend(raw, req.header('Wagend-Signature') ?? '', process.env.WAGEND_WEBHOOK_SECRET!)) {
return res.sendStatus(400)
}
const event = JSON.parse(raw)
if (event.type === 'booking.confirmed') console.log('New booking', event.data.booking.id)
res.sendStatus(200) // answer 2xx quickly; duplicates are dropped by event.id
})
app.listen(3000)
Templates by business
Each recipe matches a ready-made template you can pick during onboarding.
Barbershop
Each barber is an exclusive staff resource with their own schedule. One team, customer_choice with a round_robin fallback.
{
"name": "Haircut",
"duration_min": 30,
"step_min": 15,
"buffer_after_min": 5,
"price_cents": 5000,
"requirements": [{ "resource_group_id": "grp_barbers", "units": 1 }]
}
Aesthetics
Professionals, machines and rooms are separate resources. A service requires all three at the same time, so the scarcest one (usually the machine) limits the agenda.
{
"name": "Laser hair removal",
"duration_min": 45,
"buffer_after_min": 10,
"price_cents": 18000,
"deposit_cents": 5000,
"requirements": [
{ "resource_group_id": "grp_professionals", "units": 1 },
{ "resource_group_id": "grp_lasers", "units": 1 },
{ "resource_group_id": "grp_rooms", "units": 1 }
]
}
Clinic
Doctor plus office, per location (one workspace per location). Health data is sensitive: the assistant never asks about symptoms, and the intake form collects only what scheduling needs.
{
"name": "Appointment",
"duration_min": 30,
"buffer_after_min": 10,
"intake_form": { "type": "object", "properties": { "insurance": { "type": "string" } } },
"requirements": [
{ "resource_group_id": "grp_doctors", "units": 1 },
{ "resource_group_id": "grp_offices", "units": 1 }
]
}
Restaurant
The dining room is one pooled resource with 40 units (covers) per slot. Duration grows with the party size, and large parties require a deposit.
{
"name": "Table",
"step_min": 30,
"duration_by_units": [
{ "max_units": 2, "duration_min": 90 },
{ "max_units": 4, "duration_min": 120 },
{ "max_units": 20, "duration_min": 150 }
],
"requirements": [{ "resource_group_id": "grp_dining_room", "units": "party_size" }]
}
Table mode (specific tables with minimum and maximum size, and combinations) is on the roadmap.
Deliveries
Each zone is a pooled resource with a capacity per 2-hour window. The zone is selected by postal code, and a cutoff rule closes same-day windows at noon.
{
"name": "Delivery",
"window_mode": true,
"duration_min": 120,
"cutoff_rule": { "same_day_until": "12:00" },
"intake_form": { "type": "object", "required": ["address", "postal_code"] },
"requirements": [{ "resource_group_id": "grp_zones", "units": 1, "select_by": "postal_code" }]
}
Wagy · Set up your business with Wagy
You can skip the interview and resume from the checklist. Review the team and opening hours in a proposal before confirming. Suggested services and products remain private drafts until you complete their details and confirm them. If Wagy cannot suggest, enter them manually.
The interview shares its slots with the form: «Set up my business» combines business type, team, hours and reviewed catalog in one confirmation. The business type installs vocabulary, stages and inactive examples, without template people, hours or prices. Your plan shows the resource limit before proposing. Above 25 changes, confirm Base and then Catalog; undo them in reverse order within 24 hours if nobody changed their objects. Incomplete drafts remain private. No access invitations are sent. Edit an existing person by identity in Team.
After confirming the base, entered names are proposed in order for untouched anonymous resources from that template. Extra names create the missing resources; fewer names leave the remaining anonymous resources in place. Edited resources, resources linked to users, and resources with assignments are preserved, and confirmation checks this again. The resume button appears only while that phase is pending.
Renaming or reordering a service or product preserves the origin and state of its suggested price. Only editing the amount field confirms it. Resuming setup reuses unchanged personal schedules; editing general hours preserves each person’s exceptions.