`create_session`

Schedule a one-off session.

Authentication required

Endpoint

endpoint

https://business.sessions.website/@<handle>/api/mcp

When to use it

To add a one-off session to the schedule — a workshop, a cover class, a make-up date.
Not for recurring schedules; those are authored in the admin, where the recurrence rules live.

Parameters

startAtstringrequired

ISO 8601 start datetime (e.g. 2026-07-01T18:00:00Z).

endAtstringoptional

ISO 8601 end datetime.

durationnumberoptional

Duration in minutes (alternative to endAt).

activitystringoptional

Activity id to attach the session to (optional).

namestringoptional

Session name (optional).

Returns

The created session, or per-field validation errors. Provide a start time and either an end time or a duration in minutes.

Example

POST this to the endpoint above.

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_session",
    "arguments": {
      "startAt": "2026-09-09T13:00:00.000Z",
      "duration": 60,
      "activity": "<activity id>",
      "name": "Saturday Workshop"
    }
  }
}

content

Created session Saturday Workshop [<id>] ·
2026-09-09T13:00 → 2026-09-09T14:00.

What the agent is told

The description the model reads when deciding whether to call this. It is the only thing that decides whether the tool fires at the right moment, so it is worth knowing what it says.

create_session

Schedule a new session. Provide a start time and either an end time or a duration (minutes). Optionally attach it to an activity (by id) and give it a name. Returns the created session or validation errors.