> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to HUB Planner (Resource Flow)

The HUB Planner (Resource Flow) connector lets your AI agent act in each user's HUB Planner (Resource Flow) account. Each user connects their own HUB Planner (Resource Flow) API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 56 tools.

**Authentication:** API Key
**Categories:** Project Management
**Tools:** 56: 29 read, 18 write, 9 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=HUBPLANNER)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the HUB Planner (Resource Flow) connection

   In **AgentKit > Connections**, create a HUB Planner (Resource Flow) connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'hubplanner'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize HUB Planner (Resource Flow):', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'hubplanner_billing_rates_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "hubplanner"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize HUB Planner (Resource Flow):", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="hubplanner_billing_rates_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their HUB Planner (Resource Flow) credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'hubplanner_billing_rates_list',
  toolInput: {},
  connector: 'hubplanner',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="hubplanner_billing_rates_list",
    tool_input={},
    connection_name="hubplanner",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `hubplanner_billing_rates_list`

List Billing Rates · Read-only

List billing rates.
Returns an array of rates with _id, label, rate and currency.
Use hubplanner_billing_rates_list for pricing.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.
- `sort` (`string`, optional): Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.

Example input: `{}`

### `hubplanner_booking_categories_list`

List Booking Categories · Read-only

List booking and time entry categories.
Returns an array of categories with _id and name.
Use hubplanner_booking_categories_list to get category_template_id for time entries.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `hubplanner_booking_get`

Get Booking · Read-only

Get one booking by ID.
Returns the booking with resource, project, dates, state and details.
Use hubplanner_booking_get when you have the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `booking_id` (`string`, required): ID of the booking. Example: 5d414b23c0881e733f85f419.

Example input: `{"booking_id":"<booking_id>"}`

### `hubplanner_bookings_list`

List Bookings · Read-only

List bookings, 20 per page unless you set limit.
Returns an array of bookings with _id, resource, project, start, end, state, stateValue and type.
Use hubplanner_bookings_list to page through the schedule. Use hubplanner_bookings_search for a resource, project or date range.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `deleted` (`boolean`, optional): true to list deleted bookings instead. Example: false.
- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.
- `sort` (`string`, optional): Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.

Example input: `{}`

### `hubplanner_bookings_search`

Search Bookings · Read-only

Search bookings with a MongoDB-style query on _id, resource, project, start, end, state, type and metadata.
Returns an array of matching bookings.
Use hubplanner_bookings_search for filtered results; use the matching list tool to page through everything.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`object`, required): Search query object keyed by property. Operators: $in and $nin take arrays, $lt, $lte, $gt and $gte compare dates or numbers, $like matches part of a string. Example: {"resource": "5992a4a6e333b50c3c721c51", "start": {"$lt": "2026-12-31"}, "end": {"$gte": "2026-12-01"}}.
- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.

Example input: `{"query":{"project":"5992a4a6e583b5333c721c6d"}}`

### `hubplanner_client_get`

Get Client · Read-only

Get one client by ID.
Returns the client.
Use hubplanner_client_get when you have the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `client_id` (`string`, required): ID of the client. Example: 5d414b23c0881e733f85f419.

Example input: `{"client_id":"<client_id>"}`

### `hubplanner_clients_list`

List Clients · Read-only

List clients.
Returns an array of clients with _id, name and metadata.
Use hubplanner_clients_list to find a client ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.
- `sort` (`string`, optional): Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.

Example input: `{}`

### `hubplanner_event_get`

Get Event · Read-only

Get one event by ID.
Returns the event.
Use hubplanner_event_get when you have the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `event_id` (`string`, required): ID of the event. Example: 5d414b23c0881e733f85f419.

Example input: `{"event_id":"<event_id>"}`

### `hubplanner_events_list`

List Events · Read-only

List events (non-project activities such as training or sick leave that can be booked).
Returns an array of events with _id, name, eventCode and color.
Use hubplanner_events_list to find an event ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.
- `sort` (`string`, optional): Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.

Example input: `{}`

### `hubplanner_holidays_list`

List Public Holidays · Read-only

List public holidays.
Returns an array of holidays with name, date and repeat.
Use hubplanner_holidays_list to check non-working days.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.
- `sort` (`string`, optional): Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.

Example input: `{}`

### `hubplanner_milestone_get`

Get Milestone · Read-only

Get one milestone by ID.
Returns the milestone with name, date and project.
Use hubplanner_milestone_get when you have the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `milestone_id` (`string`, required): ID of the milestone. Example: 5d414b23c0881e733f85f419.

Example input: `{"milestone_id":"<milestone_id>"}`

### `hubplanner_milestones_search`

Search Milestones · Read-only

Search milestones with a MongoDB-style query on _id, name, date, project and metadata.
Returns an array of matching milestones.
Use hubplanner_milestones_search for filtered results; use the matching list tool to page through everything.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`object`, required): Search query object keyed by property. Operators: $in and $nin take arrays, $lt, $lte, $gt and $gte compare dates or numbers, $like matches part of a string. Example: {"project": "5992a4a6e583b5333c721c6d"}.
- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.

Example input: `{"query":{"project":"5992a4a6e583b5333c721c6d"}}`

### `hubplanner_project_custom_fields_list`

List Project Custom Fields · Read-only

List project custom field templates.
Returns an array of templates with _id, label, type and choices.
Use hubplanner_project_custom_fields_list to read the custom fields defined for projects.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `hubplanner_project_get`

Get Project · Read-only

Get one project by ID.
Returns the project with all its properties.
Use hubplanner_project_get when you have the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the project. Example: 5992a4a6e583b5333c721c6d.

Example input: `{"project_id":"<project_id>"}`

### `hubplanner_project_groups_list`

List Project Groups · Read-only

List project groups.
Returns an array of groups with _id, name and projects.
Use hubplanner_project_groups_list to see how projects are organised.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.
- `sort` (`string`, optional): Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.

Example input: `{}`

### `hubplanner_project_managers_list`

List Project Managers · Read-only

List resources who are project managers.
Returns an array of project managers.
Use hubplanner_project_managers_list to pick project_managers for a project.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `hubplanner_projects_list`

List Projects · Read-only

List all projects (all of them unless you set limit).
Returns an array of projects with _id, name, projectCode, status, dates, budget, resources and projectManagers.
Use hubplanner_projects_list to browse. Use hubplanner_projects_search to filter.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.
- `sort` (`string`, optional): Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.

Example input: `{}`

### `hubplanner_projects_search`

Search Projects · Read-only

Search projects with a MongoDB-style query on _id, name, projectCode, status, metadata, resources, start, end and custom fields.
Returns an array of matching projects.
Use hubplanner_projects_search for filtered results; use the matching list tool to page through everything.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`object`, required): Search query object keyed by property. Operators: $in and $nin take arrays, $lt, $lte, $gt and $gte compare dates or numbers, $like matches part of a string. Example: {"status": {"$in": ["STATUS_ACTIVE"]}}.
- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.

Example input: `{"query":{"project":"5992a4a6e583b5333c721c6d"}}`

### `hubplanner_resource_custom_fields_list`

List Resource Custom Fields · Read-only

List resource custom field templates.
Returns an array of templates with _id, label, type and choices.
Use hubplanner_resource_custom_fields_list to read the custom fields defined for resources.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `hubplanner_resource_get`

Get Resource · Read-only

Get one resource by ID.
Returns the resource with name, email, status, role, rates and custom fields.
Use hubplanner_resource_get when you have the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `resource_id` (`string`, required): ID of the resource. Example: 5992a4a6e333b50c3c721c51.

Example input: `{"resource_id":"<resource_id>"}`

### `hubplanner_resource_groups_list`

List Resource Groups · Read-only

List resource groups.
Returns an array of groups with _id, name and resources.
Use hubplanner_resource_groups_list to see teams.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.
- `sort` (`string`, optional): Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.

Example input: `{}`

### `hubplanner_resources_list`

List Resources · Read-only

List all resources (people and equipment that can be booked).
Returns an array of resources with _id, firstName, lastName, email, status and role.
Use hubplanner_resources_list to find a resource ID. Use hubplanner_resources_search to filter.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.
- `sort` (`string`, optional): Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.

Example input: `{}`

### `hubplanner_resources_search`

Search Resources · Read-only

Search resources with a MongoDB-style query on _id, email, firstName, lastName, status, role, metadata and custom fields.
Returns an array of matching resources.
Use hubplanner_resources_search for filtered results; use the matching list tool to page through everything.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`object`, required): Search query object keyed by property. Operators: $in and $nin take arrays, $lt, $lte, $gt and $gte compare dates or numbers, $like matches part of a string. Example: {"status": {"$in": ["STATUS_ACTIVE"]}}.
- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.

Example input: `{"query":{"project":"5992a4a6e583b5333c721c6d"}}`

### `hubplanner_time_entries_list`

List Time Entries · Read-only

List time entries, optionally for one project and a date range; 20 per page unless you set limit.
Returns an array of entries with resource, project, date, minutes, note and status.
Use hubplanner_time_entries_list for timesheets. Use hubplanner_time_entries_search for other filters.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `end` (`string`, optional): Last date (YYYY-MM-DD), inclusive. Example: 2026-11-30.
- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.
- `project` (`string`, optional): Only entries for this project ID. Example: 5992a4a6e583b5333c721c6d.
- `sort` (`string`, optional): Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.
- `start` (`string`, optional): First date (YYYY-MM-DD), inclusive. Example: 2026-11-01.

Example input: `{}`

### `hubplanner_time_entries_search`

Search Time Entries · Read-only

Search time entries with a MongoDB-style query on resource, project, date, status, metadata and categoryTemplateId.
Returns an array of matching time entries.
Use hubplanner_time_entries_search for filtered results; use the matching list tool to page through everything.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`object`, required): Search query object keyed by property. Operators: $in and $nin take arrays, $lt, $lte, $gt and $gte compare dates or numbers, $like matches part of a string. Example: {"resource": {"$in": ["5992a4a6e333b50c3c721c51"]}, "date": {"$gte": "2026-11-01", "$lte": "2026-11-30"}}.
- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.

Example input: `{"query":{"project":"5992a4a6e583b5333c721c6d"}}`

### `hubplanner_time_entry_get`

Get Time Entry · Read-only

Get one time entry by ID.
Returns the entry with resource, project, date, minutes, note, status and category.
Use hubplanner_time_entry_get when you have the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `time_entry_id` (`string`, required): ID of the time entry. Example: 5d414b23c0881e733f85f419.

Example input: `{"time_entry_id":"<time_entry_id>"}`

### `hubplanner_unassigned_work_list`

List Unassigned Work · Read-only

List unassigned work (demand not yet booked to a resource).
Returns an array of unassigned work items with project, dates and hours.
Use hubplanner_unassigned_work_list for open demand.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.
- `sort` (`string`, optional): Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.

Example input: `{}`

### `hubplanner_vacation_get`

Get Vacation · Read-only

Get one vacation entry by ID.
Returns the vacation with resource, dates, allocation and approval info.
Use hubplanner_vacation_get when you have the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `vacation_id` (`string`, required): ID of the vacation. Example: 5d414b23c0881e733f85f419.

Example input: `{"vacation_id":"<vacation_id>"}`

### `hubplanner_vacations_list`

List Vacations · Read-only

List vacation (leave) entries.
Returns an array of vacations with resource, start, end, minutesPerDay and type.
Use hubplanner_vacations_list to see who is away.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
- `page` (`integer`, optional): Page number, starting at 0. Example: 0.
- `sort` (`string`, optional): Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.

Example input: `{}`

### `hubplanner_booking_create`

Create Booking · Write

Book a resource on a project for a date range.
Returns the created booking.
Use hubplanner_booking_create to schedule work; set state and state_value, for example STATE_DAY_MINUTE and 480 for 8 hours a day.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end` (`string`, required): End date (YYYY-MM-DD), or date-time for an hourly booking. Example: 2026-12-12.
- `project` (`string`, required): Project ID. Example: 5992a4a6e583b5333c721c6d.
- `resource` (`string`, required): Resource ID. Example: 5992a4a6e333b50c3c721c51.
- `start` (`string`, required): Start date (YYYY-MM-DD), or date-time for an hourly booking. Example: 2026-12-01.
- `metadata` (`string`, optional): Free custom value. Example: ext-77.
- `note` (`string`, optional): Booking note. Example: Remote.
- `state` (`string`, optional): How state_value is read: STATE_DAY_MINUTE (minutes per day), STATE_PERCENTAGE (percent of the day) or STATE_TOTAL_MINUTE (total minutes). Example: STATE_DAY_MINUTE. One of: `STATE_DAY_MINUTE`, `STATE_PERCENTAGE`, `STATE_TOTAL_MINUTE`.
- `state_value` (`number`, optional): Booking amount in the unit set by state, for example 480 minutes per day for 8 hours. Defaults to 0, so set it. Example: 480.
- `title` (`string`, optional): Booking title. Example: Design sprint.
- `type` (`string`, optional): Set WAITING_FOR_APPROVAL to create a booking request (needs the requesting extension). Example: SCHEDULED. One of: `SCHEDULED`, `WAITING_FOR_APPROVAL`.

Example input: `{"end":"<end>","project":"<project>","resource":"<resource>","start":"<start>"}`

### `hubplanner_booking_update`

Update Booking · Write

Update a booking; only the properties you send change.
Returns the updated booking.
Use hubplanner_booking_update to move dates, change hours or approve a request.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `booking_id` (`string`, required): ID of the booking. Example: 5d414b23c0881e733f85f419.
- `end` (`string`, optional): End date (YYYY-MM-DD), or date-time for an hourly booking. Example: 2026-12-12.
- `metadata` (`string`, optional): Free custom value. Example: ext-77.
- `note` (`string`, optional): Booking note. Example: Remote.
- `project` (`string`, optional): Project ID. Example: 5992a4a6e583b5333c721c6d.
- `resource` (`string`, optional): Resource ID. Example: 5992a4a6e333b50c3c721c51.
- `start` (`string`, optional): Start date (YYYY-MM-DD), or date-time for an hourly booking. Example: 2026-12-01.
- `state` (`string`, optional): How state_value is read: STATE_DAY_MINUTE (minutes per day), STATE_PERCENTAGE (percent of the day) or STATE_TOTAL_MINUTE (total minutes). Example: STATE_DAY_MINUTE. One of: `STATE_DAY_MINUTE`, `STATE_PERCENTAGE`, `STATE_TOTAL_MINUTE`.
- `state_value` (`number`, optional): Booking amount in the unit set by state, for example 480 minutes per day for 8 hours. Defaults to 0, so set it. Example: 480.
- `title` (`string`, optional): Booking title. Example: Design sprint.
- `type` (`string`, optional): Booking type; APPROVED or REJECTED answers a booking request. Example: APPROVED. One of: `SCHEDULED`, `WAITING_FOR_APPROVAL`, `APPROVED`, `REJECTED`.

Example input: `{"booking_id":"<booking_id>"}`

### `hubplanner_client_create`

Create Client · Write

Create a client.
Returns the created client.
Use hubplanner_client_create to add a customer you run projects for.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Client name. Example: Acme Corp.
- `metadata` (`string`, optional): Free custom value. Example: crm-1001.

Example input: `{"name":"<name>"}`

### `hubplanner_client_update`

Update Client · Write

Update a client's name or metadata.
Returns the updated client.
Use hubplanner_client_update to rename a client.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `client_id` (`string`, required): ID of the client. Example: 5d414b23c0881e733f85f419.
- `metadata` (`string`, optional): Free custom value. Example: crm-1001.
- `name` (`string`, optional): Client name. Example: Acme Corporation.

Example input: `{"client_id":"<client_id>"}`

### `hubplanner_event_create`

Create Event · Write

Create an event type that can be booked like a project.
Returns the created event.
Use hubplanner_event_create for activities such as training.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Event name. Example: Training.
- `background_color` (`string`, optional): Color as a hex code. Example: #8e24aa.
- `event_code` (`string`, optional): Unique event code. Example: TRN.
- `metadata` (`string`, optional): Free custom value. Example: ext-5.

Example input: `{"name":"<name>"}`

### `hubplanner_event_update`

Update Event · Write

Update an event's name, code or color.
Returns the updated event.
Use hubplanner_event_update to rename an event.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `event_id` (`string`, required): ID of the event. Example: 5d414b23c0881e733f85f419.
- `background_color` (`string`, optional): Color as a hex code. Example: #8e24aa.
- `event_code` (`string`, optional): Unique event code. Example: TRN.
- `name` (`string`, optional): Event name. Example: Training.

Example input: `{"event_id":"<event_id>"}`

### `hubplanner_holiday_create`

Create Public Holiday · Write

Add a public holiday.
Returns the created holiday.
Use hubplanner_holiday_create to block a company-wide day off.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `date` (`string`, required): Holiday date (YYYY-MM-DD). Example: 2027-01-01.
- `name` (`string`, required): Holiday name. Example: New Year's Day.
- `repeat` (`boolean`, optional): true to repeat every year. Example: true.

Example input: `{"date":"<date>","name":"<name>"}`

### `hubplanner_milestone_create`

Create Milestone · Write

Add a milestone to a project.
Returns the created milestone.
Use hubplanner_milestone_create to mark a deadline on the schedule.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `date` (`string`, required): Milestone date (YYYY-MM-DD). Example: 2027-01-15.
- `name` (`string`, required): Milestone name. Example: Design sign-off.
- `project` (`string`, required): Project ID. Example: 5992a4a6e583b5333c721c6d.
- `metadata` (`string`, optional): Free custom value. Example: ms-1.

Example input: `{"date":"<date>","name":"<name>","project":"<project>"}`

### `hubplanner_milestone_update`

Update Milestone · Write

Update a milestone's name or date.
Returns the updated milestone.
Use hubplanner_milestone_update to move a deadline.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `milestone_id` (`string`, required): ID of the milestone. Example: 5d414b23c0881e733f85f419.
- `date` (`string`, optional): Milestone date (YYYY-MM-DD). Example: 2027-01-22.
- `name` (`string`, optional): Milestone name. Example: Design sign-off.
- `project` (`string`, optional): Project ID. Example: 5992a4a6e583b5333c721c6d.

Example input: `{"milestone_id":"<milestone_id>"}`

### `hubplanner_project_create`

Create Project · Write

Create a project.
Returns the created project with its _id.
Use hubplanner_project_create, then book people with hubplanner_booking_create.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Project name. Example: Website relaunch.
- `background_color` (`string`, optional): Project color as a hex code. Example: #1e88e5.
- `budget_cash_amount` (`number`, optional): Budgeted amount in budget_currency; 0 disables the cash budget. Example: 50000.
- `budget_currency` (`string`, optional): Currency code of the cash budget. Example: USD.
- `budget_hours` (`number`, optional): Budgeted hours; 0 disables the hours budget. Example: 400.
- `end` (`string`, optional): Project end display date (YYYY-MM-DD); used when use_project_duration is true. Example: 2027-03-31.
- `metadata` (`string`, optional): Free custom value (up to 255 characters), often your own ID. Example: crm-4471.
- `note` (`string`, optional): Project notes. Example: Phase 1 covers design.
- `project_code` (`string`, optional): Unique project code. Example: WEB-2026.
- `project_managers` (`array`, optional): Resource IDs of the project managers. Example: ["5992a4a6e333b50c3c721c51"].
- `resources` (`array`, optional): Resource IDs assigned to the project. Example: ["5992a4a6e333b50c3c721c51"].
- `start` (`string`, optional): Project start display date (YYYY-MM-DD); used when use_project_duration is true. Example: 2026-12-01.
- `status` (`string`, optional): Project status. Defaults to STATUS_ACTIVE. Example: STATUS_ACTIVE. One of: `STATUS_ACTIVE`, `STATUS_ARCHIVED`, `STATUS_PENDING`, `STATUS_PLANNED`, `STATUS_FLOATING`.
- `time_entry_enabled` (`boolean`, optional): true to allow time entries on the project. Example: true.
- `use_project_duration` (`boolean`, optional): true to show project start and end dates (then set start and end). Example: true.

Example input: `{"name":"<name>"}`

### `hubplanner_project_resources_add`

Add Resources to Project · Write

Add resources to a project's team.
Returns the updated project.
Use hubplanner_project_resources_add before booking them.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`string`, required): ID of the project. Example: 5992a4a6e583b5333c721c6d.
- `resource_ids` (`array`, required): Resource IDs to add. Example: ["5992a4a6e333b50c3c721c51"].

Example input: `{"project_id":"<project_id>","resource_ids":["5992a4a6e333b50c3c721c51"]}`

### `hubplanner_project_update`

Update Project · Write

Update a project; only the properties you send change.
Returns the updated project in an array.
Use hubplanner_project_update to rename, archive or change budgets.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_id` (`string`, required): ID of the project to update. Example: 5992a4a6e583b5333c721c6d.
- `background_color` (`string`, optional): Project color as a hex code. Example: #1e88e5.
- `budget_cash_amount` (`number`, optional): Budgeted amount in budget_currency; 0 disables the cash budget. Example: 50000.
- `budget_currency` (`string`, optional): Currency code of the cash budget. Example: USD.
- `budget_hours` (`number`, optional): Budgeted hours; 0 disables the hours budget. Example: 400.
- `end` (`string`, optional): Project end display date (YYYY-MM-DD); used when use_project_duration is true. Example: 2027-03-31.
- `metadata` (`string`, optional): Free custom value (up to 255 characters), often your own ID. Example: crm-4471.
- `name` (`string`, optional): Project name. Example: Website relaunch.
- `note` (`string`, optional): Project notes. Example: Phase 1 covers design.
- `project_code` (`string`, optional): Unique project code. Example: WEB-2026.
- `project_managers` (`array`, optional): Resource IDs of the project managers. Example: ["5992a4a6e333b50c3c721c51"].
- `resources` (`array`, optional): Resource IDs assigned to the project. Example: ["5992a4a6e333b50c3c721c51"].
- `start` (`string`, optional): Project start display date (YYYY-MM-DD); used when use_project_duration is true. Example: 2026-12-01.
- `status` (`string`, optional): Project status. Defaults to STATUS_ACTIVE. Example: STATUS_ACTIVE. One of: `STATUS_ACTIVE`, `STATUS_ARCHIVED`, `STATUS_PENDING`, `STATUS_PLANNED`, `STATUS_FLOATING`.
- `time_entry_enabled` (`boolean`, optional): true to allow time entries on the project. Example: true.
- `use_project_duration` (`boolean`, optional): true to show project start and end dates (then set start and end). Example: true.

Example input: `{"project_id":"<project_id>"}`

### `hubplanner_resource_create`

Create Resource · Write

Create a resource (a person or bookable item).
Returns the created resource with its _id.
Use hubplanner_resource_create to add a team member.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `first_name` (`string`, required): First name. Example: Alex.
- `email` (`string`, optional): Email address (unique). Example: alex.morgan@example.com.
- `last_name` (`string`, optional): Last name. Example: Morgan.
- `metadata` (`string`, optional): Free custom value (up to 255 characters), often your own ID. Example: hr-1029.
- `note` (`string`, optional): Notes about the resource. Example: Senior designer.
- `status` (`string`, optional): Resource status. Example: STATUS_ACTIVE. One of: `STATUS_ACTIVE`, `STATUS_ARCHIVED`, `STATUS_NON_BOOKABLE`.

Example input: `{"first_name":"<first_name>"}`

### `hubplanner_resource_projects_remove`

Remove Resource from Projects · Write

Remove a resource from one or more projects.
Returns the result.
Use hubplanner_resource_projects_remove when someone leaves a project team.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `project_ids` (`array`, required): Project IDs to remove the resource from. Example: ["5992a4a6e583b5333c721c6d"].
- `resource_id` (`string`, required): ID of the resource. Example: 5992a4a6e333b50c3c721c51.

Example input: `{"project_ids":["5992a4a6e583b5333c721c6d"],"resource_id":"<resource_id>"}`

### `hubplanner_resource_update`

Update Resource · Write

Update a resource; only the properties you send change.
Returns the updated resource in an array.
Use hubplanner_resource_update to change names, email or status.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `resource_id` (`string`, required): ID of the resource to update. Example: 5992a4a6e333b50c3c721c51.
- `email` (`string`, optional): Email address (unique). Example: alex.morgan@example.com.
- `first_name` (`string`, optional): First name. Example: Alex.
- `last_name` (`string`, optional): Last name. Example: Morgan.
- `metadata` (`string`, optional): Free custom value (up to 255 characters), often your own ID. Example: hr-1029.
- `note` (`string`, optional): Notes about the resource. Example: Senior designer.
- `status` (`string`, optional): Resource status. Example: STATUS_ACTIVE. One of: `STATUS_ACTIVE`, `STATUS_ARCHIVED`, `STATUS_NON_BOOKABLE`.

Example input: `{"resource_id":"<resource_id>"}`

### `hubplanner_time_entry_create`

Create Time Entry · Write

Log time for a resource on a project and date.
Returns the created time entry.
Use hubplanner_time_entry_create to record hours worked.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `date` (`string`, required): Date of the entry (YYYY-MM-DD). Example: 2026-11-16.
- `minutes` (`integer`, required): Minutes worked. Example: 240.
- `project` (`string`, required): Project ID. Example: 5992a4a6e583b5333c721c6d.
- `resource` (`string`, required): Resource ID. Example: 5992a4a6e333b50c3c721c51.
- `category_template_id` (`string`, optional): ID of the booking category. Example: 5d414b23c0881e733f85f419.
- `metadata` (`string`, optional): Free custom value. Example: ext-88.
- `note` (`string`, optional): Note; required when the project sets timeEntryNoteRequired. Example: Client workshop.

Example input: `{"date":"<date>","minutes":240,"project":"<project>","resource":"<resource>"}`

### `hubplanner_time_entry_update`

Update Time Entry · Write

Update a time entry's minutes, date, note or category.
Returns the updated entry.
Use hubplanner_time_entry_update to correct hours; locked entries cannot change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `time_entry_id` (`string`, required): ID of the time entry. Example: 5d414b23c0881e733f85f419.
- `category_template_id` (`string`, optional): ID of the booking category. Example: 5d414b23c0881e733f85f419.
- `date` (`string`, optional): Date of the entry (YYYY-MM-DD). Example: 2026-11-16.
- `metadata` (`string`, optional): Free custom value. Example: ext-88.
- `minutes` (`integer`, optional): Minutes worked. Example: 240.
- `note` (`string`, optional): Note; required when the project sets timeEntryNoteRequired. Example: Client workshop.
- `project` (`string`, optional): Project ID. Example: 5992a4a6e583b5333c721c6d.
- `resource` (`string`, optional): Resource ID. Example: 5992a4a6e333b50c3c721c51.

Example input: `{"time_entry_id":"<time_entry_id>"}`

### `hubplanner_vacation_create`

Create Vacation · Write

Book vacation (leave) for a resource.
Returns the created vacation.
Use hubplanner_vacation_create to record time off.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end` (`string`, required): Last day (YYYY-MM-DD). Example: 2026-12-31.
- `resource` (`string`, required): Resource ID. Example: 5992a4a6e333b50c3c721c51.
- `start` (`string`, required): First day (YYYY-MM-DD). Example: 2026-12-22.
- `minutes_per_day` (`integer`, optional): Minutes per day. Defaults to 480 (a full day). Example: 480.
- `title` (`string`, optional): Title. Example: Winter holiday.
- `type` (`string`, optional): Vacation type, for example APPROVED or WAITING_FOR_APPROVAL. Example: APPROVED. One of: `SCHEDULED`, `WAITING_FOR_APPROVAL`, `APPROVED`, `REJECTED`.

Example input: `{"end":"<end>","resource":"<resource>","start":"<start>"}`

### `hubplanner_booking_delete`

Delete Booking · Destructive

Delete a booking.
Returns the deleted booking.
Use hubplanner_booking_delete to remove scheduled work.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `booking_id` (`string`, required): ID of the booking. Example: 5d414b23c0881e733f85f419.

Example input: `{"booking_id":"<booking_id>"}`

### `hubplanner_client_delete`

Delete Client · Destructive

Delete a client.
Returns the deleted client.
Use hubplanner_client_delete to remove a client.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `client_id` (`string`, required): ID of the client. Example: 5d414b23c0881e733f85f419.

Example input: `{"client_id":"<client_id>"}`

### `hubplanner_event_delete`

Delete Event · Destructive

Delete an event.
Returns the deleted event.
Use hubplanner_event_delete to remove an unused event.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `event_id` (`string`, required): ID of the event. Example: 5d414b23c0881e733f85f419.

Example input: `{"event_id":"<event_id>"}`

### `hubplanner_holiday_delete`

Delete Public Holiday · Destructive

Delete a public holiday.
Returns the deleted holiday.
Use hubplanner_holiday_delete to remove a holiday.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `holiday_id` (`string`, required): ID of the holiday. Example: 5d414b23c0881e733f85f419.

Example input: `{"holiday_id":"<holiday_id>"}`

### `hubplanner_milestone_delete`

Delete Milestone · Destructive

Delete a milestone.
Returns the deleted milestone.
Use hubplanner_milestone_delete to remove a deadline.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `milestone_id` (`string`, required): ID of the milestone. Example: 5d414b23c0881e733f85f419.

Example input: `{"milestone_id":"<milestone_id>"}`

### `hubplanner_project_delete`

Delete Project · Destructive

Delete a project.
Returns the deleted project.
Use hubplanner_project_delete for mistakes; archive real projects with hubplanner_project_update.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the project. Example: 5992a4a6e583b5333c721c6d.

Example input: `{"project_id":"<project_id>"}`

### `hubplanner_resource_delete`

Delete Resource · Destructive

Delete a resource.
Returns the deleted resource.
Use hubplanner_resource_delete for mistakes; archive real people with hubplanner_resource_update.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `resource_id` (`string`, required): ID of the resource. Example: 5992a4a6e333b50c3c721c51.

Example input: `{"resource_id":"<resource_id>"}`

### `hubplanner_time_entry_delete`

Delete Time Entry · Destructive

Delete a time entry.
Returns the deleted entry.
Use hubplanner_time_entry_delete to remove a wrong entry.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `time_entry_id` (`string`, required): ID of the time entry. Example: 5d414b23c0881e733f85f419.

Example input: `{"time_entry_id":"<time_entry_id>"}`

### `hubplanner_vacation_delete`

Delete Vacation · Destructive

Delete a vacation entry.
Returns the deleted vacation.
Use hubplanner_vacation_delete to cancel time off.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `vacation_id` (`string`, required): ID of the vacation. Example: 5d414b23c0881e733f85f419.

Example input: `{"vacation_id":"<vacation_id>"}`

## Related

Other Project Management connectors ([all 67](/agentkit/connectors/?category=project-management)):

- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools
- [Airtable](/agentkit/connectors/airtable/): Scalekit connector, OAuth, 26 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
