Planity logo Planity automation · runs weekly

Block staff time off in the Planity agenda

A stylist asks for every Monday morning off from next week, and until the owner blocks it, clients can still book those hours online.

Cotlet does it in your own Planity account with list_staff, list_appointments and block_time, called by your AI agent, an n8n workflow or a script.

Sign up free All Planity tools

Hosted · nothing to install or maintain

Can Planity do this on its own?

Planity blocks time per staff member by hand in the agenda and has no API for it (checked 23 Oct 2026). It does not list the appointments that were booked before the block. Deadlines for online booking and cancellation are a separate setting.

How you do it in Planity today

  1. In the agenda, the owner clicks the start time in the column of the staff member.
  2. The owner picks the end time of the unavailability, which makes a block of that length.
  3. For a block that repeats, the owner clicks "Répéter" and sets it to every day or once a week, for example.
  4. The owner clicks "Valider" at the top right. From then on nobody can book online in those hours.
  5. Bookings made before the block stay in the agenda. The owner finds them by reading the column and moves or deletes each one by hand.

How to block staff time off in the Planity agenda

Prompt

Block Amélie's agenda every Monday from 9:00 to 13:00 starting 26 October. List the appointments already booked in those hours so I can move them.
  1. 01

    Find the staff member

    list_staff returns the ids of the agenda columns. The agent matches the name in your prompt. If two staff members share a first name, it asks which one instead of blocking the wrong column.

  2. 02

    Look at the hours first

    list_appointments runs for each date the block covers, filtered to that staff member, and returns the appointments inside the blocked hours. A weekly block is checked for the next few Mondays, because that is when the clash is likely.

  3. 03

    Block the time

    block_time creates the block with repeat set to weekly. It reaches no client and remove_block undoes it, so it does not wait for your OK. It leaves existing appointments where they are.

  4. 04

    Hand over the clashes

    The agent lists every appointment inside the block with client, service and time. It does not move any on its own: update_appointment and delete_appointment each wait for your OK, and Planity deletes one appointment at a time.

  5. 05

    Report

    The agent returns the block id, the staff member and the repeat rule, so you can check the agenda column or remove the block later.

What you get back

Example data

Blocked: Amélie, Mondays 9:00 to 13:00 from 26 Oct (weekly)
Online booking closed in those hours
Appointments already inside the block: 2
- Mon 26 Oct 9:30 Léa Martin, Coupe femme
- Mon 2 Nov 10:00 Hugo Martin, Brushing

Other ways to ask

  • Block Lucas from 24 to 31 December, all day, and list who is booked.
  • Block every staff member for one hour at 13:00 each day for the team lunch.
  • Remove the Monday block for Amélie starting in January.

What Planity allows, and what to know first

  • Planity describes the block for one-off absences such as holidays and recurring ones such as a weekly day off.
  • With a block in place, Planity says no client can book online in the blocked hours.
  • Planity lets you delete appointments from the agenda without being bound by the cancellation deadline, one appointment at a time, with no bulk delete.
  • Online booking and cancellation deadlines are set under Admin > Paramètres Etablissement > Gestion horaires et délais > Délais RDV en ligne, and they apply to clients, not to a block.

block_time changes only your own Planity data and reach no one else, so it runs without asking first.

Sources: Planity Help: How to block a staff member's agenda for a slot · Planity Help: How to change or delete an appointment · Planity Help: How to change booking and cancellation deadlines

Call block_time from a script

curl

curl -X POST https://cotlet.dev/api/v1/planity/staffs/st_01/time/block \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2026-10-26T09:00:00","end":"2026-10-26T13:00:00","repeat":"weekly"}'

Example response

{
  "block_id": "b_330",
  "staff": {
    "staff_id": "st_01",
    "name": "Amélie"
  },
  "start": "2026-10-26T09:00:00",
  "end": "2026-10-26T13:00:00",
  "repeat": "weekly",
  "online_booking_blocked": true
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is planity_write → block_time. Example data.

Schedule it in n8n, Make, Zapier or cron

Planity tools this automation uses

Cotlet Planity tools used to block staff time off in the Planity agenda
Tool Parameters
list_staff none
list_appointments date_from, date_to, staff_id, client_id
block_time staff_id, start, end, repeat
All 14 Planity tools with descriptions

Frequently asked questions

Is it safe to connect Planity to Cotlet?

Yes. You sign in to Planity yourself, in your own Cloud Browser in the EU, and we never save your password. Your agents only get Planity once you enable it, every background request is listed, and the browser profile is stored encrypted with AES-256-GCM, the cipher 1Password uses for its vaults. The AI model never sees a login, posts and messages wait for your OK, and Disable for agents cuts access in one click. Independent scanners grade cotlet.dev A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory; live results are on https://cotlet.dev/security.

Give your agent access to Planity.

Free 7-day trial with 2,000 credits, no card needed. Cotlet is independent and not affiliated with Planity.

Sign up free