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.
- Tools
- 56
- What they doRead · write · destructive
- 29 · 18 · 929 read18 write9 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>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_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'hubplanner'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'hubplanner_billing_rates_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "hubplanner"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="hubplanner_billing_rates_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their HUB Planner (Resource Flow) credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolhubplanner_billing_rates_listList billing rates.Read-onlyList Billing Rates
List billing rates. Returns an array of rates with _id, label, rate and currency. Use hubplanner_billing_rates_list for pricing.
Inputs
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
sortstring- Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.
hubplanner_booking_categories_listList booking and time entry categories.Read-onlyList Booking Categories
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.
Inputs
This tool takes no inputs.
hubplanner_booking_getGet one booking by ID.Read-onlyGet Booking
Get one booking by ID. Returns the booking with resource, project, dates, state and details. Use hubplanner_booking_get when you have the ID.
Inputs
booking_idstringrequired- ID of the booking. Example: 5d414b23c0881e733f85f419.
hubplanner_bookings_listList bookings, 20 per page unless you set limit.Read-onlyList Bookings
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.
Inputs
deletedboolean- true to list deleted bookings instead. Example: false.
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
sortstring- Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.
hubplanner_bookings_searchSearch bookings with a MongoDB-style query on _id, resource, project, start, end, state, type and metadata.Read-onlySearch Bookings
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.
Inputs
queryobjectrequired- 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"}}.
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
hubplanner_client_getGet one client by ID.Read-onlyGet Client
Get one client by ID. Returns the client. Use hubplanner_client_get when you have the ID.
Inputs
client_idstringrequired- ID of the client. Example: 5d414b23c0881e733f85f419.
hubplanner_clients_listList clients.Read-onlyList Clients
List clients. Returns an array of clients with _id, name and metadata. Use hubplanner_clients_list to find a client ID.
Inputs
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
sortstring- Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.
hubplanner_event_getGet one event by ID.Read-onlyGet Event
Get one event by ID. Returns the event. Use hubplanner_event_get when you have the ID.
Inputs
event_idstringrequired- ID of the event. Example: 5d414b23c0881e733f85f419.
hubplanner_events_listList events (non-project activities such as training or sick leave that can be booked).Read-onlyList Events
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.
Inputs
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
sortstring- Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.
hubplanner_holidays_listList public holidays.Read-onlyList Public Holidays
List public holidays. Returns an array of holidays with name, date and repeat. Use hubplanner_holidays_list to check non-working days.
Inputs
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
sortstring- Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.
hubplanner_milestone_getGet one milestone by ID.Read-onlyGet Milestone
Get one milestone by ID. Returns the milestone with name, date and project. Use hubplanner_milestone_get when you have the ID.
Inputs
milestone_idstringrequired- ID of the milestone. Example: 5d414b23c0881e733f85f419.
hubplanner_milestones_searchSearch milestones with a MongoDB-style query on _id, name, date, project and metadata.Read-onlySearch Milestones
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.
Inputs
queryobjectrequired- 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"}.
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
hubplanner_project_custom_fields_listList project custom field templates.Read-onlyList Project Custom Fields
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.
Inputs
This tool takes no inputs.
hubplanner_project_getGet one project by ID.Read-onlyGet Project
Get one project by ID. Returns the project with all its properties. Use hubplanner_project_get when you have the ID.
Inputs
project_idstringrequired- ID of the project. Example: 5992a4a6e583b5333c721c6d.
hubplanner_project_groups_listList project groups.Read-onlyList Project Groups
List project groups. Returns an array of groups with _id, name and projects. Use hubplanner_project_groups_list to see how projects are organised.
Inputs
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
sortstring- Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.
hubplanner_project_managers_listList resources who are project managers.Read-onlyList Project Managers
List resources who are project managers. Returns an array of project managers. Use hubplanner_project_managers_list to pick project_managers for a project.
Inputs
This tool takes no inputs.
hubplanner_projects_listList all projects (all of them unless you set limit).Read-onlyList Projects
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.
Inputs
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
sortstring- Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.
hubplanner_projects_searchSearch projects with a MongoDB-style query on _id, name, projectCode, status, metadata, resources, start, end and custom fields.Read-onlySearch Projects
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.
Inputs
queryobjectrequired- 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"]}}.
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
hubplanner_resource_custom_fields_listList resource custom field templates.Read-onlyList Resource Custom Fields
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.
Inputs
This tool takes no inputs.
hubplanner_resource_getGet one resource by ID.Read-onlyGet Resource
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.
Inputs
resource_idstringrequired- ID of the resource. Example: 5992a4a6e333b50c3c721c51.
hubplanner_resource_groups_listList resource groups.Read-onlyList Resource Groups
List resource groups. Returns an array of groups with _id, name and resources. Use hubplanner_resource_groups_list to see teams.
Inputs
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
sortstring- Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.
hubplanner_resources_listList all resources (people and equipment that can be booked).Read-onlyList Resources
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.
Inputs
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
sortstring- Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.
hubplanner_resources_searchSearch resources with a MongoDB-style query on _id, email, firstName, lastName, status, role, metadata and custom fields.Read-onlySearch Resources
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.
Inputs
queryobjectrequired- 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"]}}.
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
hubplanner_time_entries_listList time entries, optionally for one project and a date range; 20 per page unless you set limit.Read-onlyList Time Entries
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.
Inputs
endstring- Last date (YYYY-MM-DD), inclusive. Example: 2026-11-30.
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
projectstring- Only entries for this project ID. Example: 5992a4a6e583b5333c721c6d.
sortstring- Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.
startstring- First date (YYYY-MM-DD), inclusive. Example: 2026-11-01.
hubplanner_time_entries_searchSearch time entries with a MongoDB-style query on resource, project, date, status, metadata and categoryTemplateId.Read-onlySearch Time Entries
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.
Inputs
queryobjectrequired- 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"}}.
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
hubplanner_time_entry_getGet one time entry by ID.Read-onlyGet Time Entry
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.
Inputs
time_entry_idstringrequired- ID of the time entry. Example: 5d414b23c0881e733f85f419.
hubplanner_unassigned_work_listList unassigned work (demand not yet booked to a resource).Read-onlyList Unassigned Work
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.
Inputs
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
sortstring- Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.
hubplanner_vacation_getGet one vacation entry by ID.Read-onlyGet Vacation
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.
Inputs
vacation_idstringrequired- ID of the vacation. Example: 5d414b23c0881e733f85f419.
hubplanner_vacations_listList vacation (leave) entries.Read-onlyList Vacations
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.
Inputs
limitinteger- Results per page, 1 to 1000. Without it, projects and resources return everything and bookings and time entries return 20. Example: 100.
pageinteger- Page number, starting at 0. Example: 0.
sortstring- Property to sort by; prefix with - for descending, for example -createdDate. Example: -updatedDate.
hubplanner_booking_createBook a resource on a project for a date range.WriteCreate Booking
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.
Inputs
endstringrequired- End date (YYYY-MM-DD), or date-time for an hourly booking. Example: 2026-12-12.
projectstringrequired- Project ID. Example: 5992a4a6e583b5333c721c6d.
resourcestringrequired- Resource ID. Example: 5992a4a6e333b50c3c721c51.
startstringrequired- Start date (YYYY-MM-DD), or date-time for an hourly booking. Example: 2026-12-01.
metadatastring- Free custom value. Example: ext-77.
notestring- Booking note. Example: Remote.
statestring- 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_MINUTESTATE_PERCENTAGESTATE_TOTAL_MINUTE state_valuenumber- 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.
titlestring- Booking title. Example: Design sprint.
typestring- Set WAITING_FOR_APPROVAL to create a booking request (needs the requesting extension). Example: SCHEDULED.one of
SCHEDULEDWAITING_FOR_APPROVAL
hubplanner_booking_updateUpdate a booking; only the properties you send change.WriteUpdate Booking
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.
Inputs
booking_idstringrequired- ID of the booking. Example: 5d414b23c0881e733f85f419.
endstring- End date (YYYY-MM-DD), or date-time for an hourly booking. Example: 2026-12-12.
metadatastring- Free custom value. Example: ext-77.
notestring- Booking note. Example: Remote.
projectstring- Project ID. Example: 5992a4a6e583b5333c721c6d.
resourcestring- Resource ID. Example: 5992a4a6e333b50c3c721c51.
startstring- Start date (YYYY-MM-DD), or date-time for an hourly booking. Example: 2026-12-01.
statestring- 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_MINUTESTATE_PERCENTAGESTATE_TOTAL_MINUTE state_valuenumber- 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.
titlestring- Booking title. Example: Design sprint.
typestring- Booking type; APPROVED or REJECTED answers a booking request. Example: APPROVED.one of
SCHEDULEDWAITING_FOR_APPROVALAPPROVEDREJECTED
hubplanner_client_createCreate a client.WriteCreate Client
Create a client. Returns the created client. Use hubplanner_client_create to add a customer you run projects for.
Inputs
namestringrequired- Client name. Example: Acme Corp.
metadatastring- Free custom value. Example: crm-1001.
hubplanner_client_updateUpdate a client's name or metadata.WriteUpdate Client
Update a client's name or metadata. Returns the updated client. Use hubplanner_client_update to rename a client.
- Idempotent
Inputs
client_idstringrequired- ID of the client. Example: 5d414b23c0881e733f85f419.
metadatastring- Free custom value. Example: crm-1001.
namestring- Client name. Example: Acme Corporation.
hubplanner_event_createCreate an event type that can be booked like a project.WriteCreate Event
Create an event type that can be booked like a project. Returns the created event. Use hubplanner_event_create for activities such as training.
Inputs
namestringrequired- Event name. Example: Training.
background_colorstring- Color as a hex code. Example: #8e24aa.
event_codestring- Unique event code. Example: TRN.
metadatastring- Free custom value. Example: ext-5.
hubplanner_event_updateUpdate an event's name, code or color.WriteUpdate Event
Update an event's name, code or color. Returns the updated event. Use hubplanner_event_update to rename an event.
- Idempotent
Inputs
event_idstringrequired- ID of the event. Example: 5d414b23c0881e733f85f419.
background_colorstring- Color as a hex code. Example: #8e24aa.
event_codestring- Unique event code. Example: TRN.
namestring- Event name. Example: Training.
hubplanner_holiday_createAdd a public holiday.WriteCreate Public Holiday
Add a public holiday. Returns the created holiday. Use hubplanner_holiday_create to block a company-wide day off.
Inputs
datestringrequired- Holiday date (YYYY-MM-DD). Example: 2027-01-01.
namestringrequired- Holiday name. Example: New Year's Day.
repeatboolean- true to repeat every year. Example: true.
hubplanner_milestone_createAdd a milestone to a project.WriteCreate Milestone
Add a milestone to a project. Returns the created milestone. Use hubplanner_milestone_create to mark a deadline on the schedule.
Inputs
datestringrequired- Milestone date (YYYY-MM-DD). Example: 2027-01-15.
namestringrequired- Milestone name. Example: Design sign-off.
projectstringrequired- Project ID. Example: 5992a4a6e583b5333c721c6d.
metadatastring- Free custom value. Example: ms-1.
hubplanner_milestone_updateUpdate a milestone's name or date.WriteUpdate Milestone
Update a milestone's name or date. Returns the updated milestone. Use hubplanner_milestone_update to move a deadline.
- Idempotent
Inputs
milestone_idstringrequired- ID of the milestone. Example: 5d414b23c0881e733f85f419.
datestring- Milestone date (YYYY-MM-DD). Example: 2027-01-22.
namestring- Milestone name. Example: Design sign-off.
projectstring- Project ID. Example: 5992a4a6e583b5333c721c6d.
hubplanner_project_createCreate a project.WriteCreate Project
Create a project. Returns the created project with its _id. Use hubplanner_project_create, then book people with hubplanner_booking_create.
Inputs
namestringrequired- Project name. Example: Website relaunch.
background_colorstring- Project color as a hex code. Example: #1e88e5.
budget_cash_amountnumber- Budgeted amount in budget_currency; 0 disables the cash budget. Example: 50000.
budget_currencystring- Currency code of the cash budget. Example: USD.
budget_hoursnumber- Budgeted hours; 0 disables the hours budget. Example: 400.
endstring- Project end display date (YYYY-MM-DD); used when use_project_duration is true. Example: 2027-03-31.
metadatastring- Free custom value (up to 255 characters), often your own ID. Example: crm-4471.
notestring- Project notes. Example: Phase 1 covers design.
project_codestring- Unique project code. Example: WEB-2026.
project_managersarray- Resource IDs of the project managers. Example: ["5992a4a6e333b50c3c721c51"].
resourcesarray- Resource IDs assigned to the project. Example: ["5992a4a6e333b50c3c721c51"].
startstring- Project start display date (YYYY-MM-DD); used when use_project_duration is true. Example: 2026-12-01.
statusstring- Project status. Defaults to STATUS_ACTIVE. Example: STATUS_ACTIVE.one of
STATUS_ACTIVESTATUS_ARCHIVEDSTATUS_PENDINGSTATUS_PLANNEDSTATUS_FLOATING time_entry_enabledboolean- true to allow time entries on the project. Example: true.
use_project_durationboolean- true to show project start and end dates (then set start and end). Example: true.
hubplanner_project_resources_addAdd resources to a project's team.WriteAdd Resources to Project
Add resources to a project's team. Returns the updated project. Use hubplanner_project_resources_add before booking them.
Inputs
project_idstringrequired- ID of the project. Example: 5992a4a6e583b5333c721c6d.
resource_idsarrayrequired- Resource IDs to add. Example: ["5992a4a6e333b50c3c721c51"].
hubplanner_project_updateUpdate a project; only the properties you send change.WriteUpdate Project
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.
Inputs
project_idstringrequired- ID of the project to update. Example: 5992a4a6e583b5333c721c6d.
background_colorstring- Project color as a hex code. Example: #1e88e5.
budget_cash_amountnumber- Budgeted amount in budget_currency; 0 disables the cash budget. Example: 50000.
budget_currencystring- Currency code of the cash budget. Example: USD.
budget_hoursnumber- Budgeted hours; 0 disables the hours budget. Example: 400.
endstring- Project end display date (YYYY-MM-DD); used when use_project_duration is true. Example: 2027-03-31.
metadatastring- Free custom value (up to 255 characters), often your own ID. Example: crm-4471.
namestring- Project name. Example: Website relaunch.
notestring- Project notes. Example: Phase 1 covers design.
project_codestring- Unique project code. Example: WEB-2026.
project_managersarray- Resource IDs of the project managers. Example: ["5992a4a6e333b50c3c721c51"].
resourcesarray- Resource IDs assigned to the project. Example: ["5992a4a6e333b50c3c721c51"].
startstring- Project start display date (YYYY-MM-DD); used when use_project_duration is true. Example: 2026-12-01.
statusstring- Project status. Defaults to STATUS_ACTIVE. Example: STATUS_ACTIVE.one of
STATUS_ACTIVESTATUS_ARCHIVEDSTATUS_PENDINGSTATUS_PLANNEDSTATUS_FLOATING time_entry_enabledboolean- true to allow time entries on the project. Example: true.
use_project_durationboolean- true to show project start and end dates (then set start and end). Example: true.
hubplanner_resource_createCreate a resource (a person or bookable item).WriteCreate Resource
Create a resource (a person or bookable item). Returns the created resource with its _id. Use hubplanner_resource_create to add a team member.
Inputs
first_namestringrequired- First name. Example: Alex.
emailstring- Email address (unique). Example: alex.morgan@example.com.
last_namestring- Last name. Example: Morgan.
metadatastring- Free custom value (up to 255 characters), often your own ID. Example: hr-1029.
notestring- Notes about the resource. Example: Senior designer.
statusstring- Resource status. Example: STATUS_ACTIVE.one of
STATUS_ACTIVESTATUS_ARCHIVEDSTATUS_NON_BOOKABLE
hubplanner_resource_projects_removeRemove a resource from one or more projects.WriteRemove Resource from Projects
Remove a resource from one or more projects. Returns the result. Use hubplanner_resource_projects_remove when someone leaves a project team.
Inputs
project_idsarrayrequired- Project IDs to remove the resource from. Example: ["5992a4a6e583b5333c721c6d"].
resource_idstringrequired- ID of the resource. Example: 5992a4a6e333b50c3c721c51.
hubplanner_resource_updateUpdate a resource; only the properties you send change.WriteUpdate Resource
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.
Inputs
resource_idstringrequired- ID of the resource to update. Example: 5992a4a6e333b50c3c721c51.
emailstring- Email address (unique). Example: alex.morgan@example.com.
first_namestring- First name. Example: Alex.
last_namestring- Last name. Example: Morgan.
metadatastring- Free custom value (up to 255 characters), often your own ID. Example: hr-1029.
notestring- Notes about the resource. Example: Senior designer.
statusstring- Resource status. Example: STATUS_ACTIVE.one of
STATUS_ACTIVESTATUS_ARCHIVEDSTATUS_NON_BOOKABLE
hubplanner_time_entry_createLog time for a resource on a project and date.WriteCreate Time Entry
Log time for a resource on a project and date. Returns the created time entry. Use hubplanner_time_entry_create to record hours worked.
Inputs
datestringrequired- Date of the entry (YYYY-MM-DD). Example: 2026-11-16.
minutesintegerrequired- Minutes worked. Example: 240.
projectstringrequired- Project ID. Example: 5992a4a6e583b5333c721c6d.
resourcestringrequired- Resource ID. Example: 5992a4a6e333b50c3c721c51.
category_template_idstring- ID of the booking category. Example: 5d414b23c0881e733f85f419.
metadatastring- Free custom value. Example: ext-88.
notestring- Note; required when the project sets timeEntryNoteRequired. Example: Client workshop.
hubplanner_time_entry_updateUpdate a time entry's minutes, date, note or category.WriteUpdate Time Entry
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.
- Idempotent
Inputs
time_entry_idstringrequired- ID of the time entry. Example: 5d414b23c0881e733f85f419.
category_template_idstring- ID of the booking category. Example: 5d414b23c0881e733f85f419.
datestring- Date of the entry (YYYY-MM-DD). Example: 2026-11-16.
metadatastring- Free custom value. Example: ext-88.
minutesinteger- Minutes worked. Example: 240.
notestring- Note; required when the project sets timeEntryNoteRequired. Example: Client workshop.
projectstring- Project ID. Example: 5992a4a6e583b5333c721c6d.
resourcestring- Resource ID. Example: 5992a4a6e333b50c3c721c51.
hubplanner_vacation_createBook vacation (leave) for a resource.WriteCreate Vacation
Book vacation (leave) for a resource. Returns the created vacation. Use hubplanner_vacation_create to record time off.
Inputs
endstringrequired- Last day (YYYY-MM-DD). Example: 2026-12-31.
resourcestringrequired- Resource ID. Example: 5992a4a6e333b50c3c721c51.
startstringrequired- First day (YYYY-MM-DD). Example: 2026-12-22.
minutes_per_dayinteger- Minutes per day. Defaults to 480 (a full day). Example: 480.
titlestring- Title. Example: Winter holiday.
typestring- Vacation type, for example APPROVED or WAITING_FOR_APPROVAL. Example: APPROVED.one of
SCHEDULEDWAITING_FOR_APPROVALAPPROVEDREJECTED
hubplanner_booking_deleteDelete a booking.DestructiveDelete Booking
Delete a booking. Returns the deleted booking. Use hubplanner_booking_delete to remove scheduled work.
- Idempotent
Inputs
booking_idstringrequired- ID of the booking. Example: 5d414b23c0881e733f85f419.
hubplanner_client_deleteDelete a client.DestructiveDelete Client
Delete a client. Returns the deleted client. Use hubplanner_client_delete to remove a client.
- Idempotent
Inputs
client_idstringrequired- ID of the client. Example: 5d414b23c0881e733f85f419.
hubplanner_event_deleteDelete an event.DestructiveDelete Event
Delete an event. Returns the deleted event. Use hubplanner_event_delete to remove an unused event.
- Idempotent
Inputs
event_idstringrequired- ID of the event. Example: 5d414b23c0881e733f85f419.
hubplanner_holiday_deleteDelete a public holiday.DestructiveDelete Public Holiday
Delete a public holiday. Returns the deleted holiday. Use hubplanner_holiday_delete to remove a holiday.
- Idempotent
Inputs
holiday_idstringrequired- ID of the holiday. Example: 5d414b23c0881e733f85f419.
hubplanner_milestone_deleteDelete a milestone.DestructiveDelete Milestone
Delete a milestone. Returns the deleted milestone. Use hubplanner_milestone_delete to remove a deadline.
- Idempotent
Inputs
milestone_idstringrequired- ID of the milestone. Example: 5d414b23c0881e733f85f419.
hubplanner_project_deleteDelete a project.DestructiveDelete Project
Delete a project. Returns the deleted project. Use hubplanner_project_delete for mistakes; archive real projects with hubplanner_project_update.
- Idempotent
Inputs
project_idstringrequired- ID of the project. Example: 5992a4a6e583b5333c721c6d.
hubplanner_resource_deleteDelete a resource.DestructiveDelete Resource
Delete a resource. Returns the deleted resource. Use hubplanner_resource_delete for mistakes; archive real people with hubplanner_resource_update.
- Idempotent
Inputs
resource_idstringrequired- ID of the resource. Example: 5992a4a6e333b50c3c721c51.
hubplanner_time_entry_deleteDelete a time entry.DestructiveDelete Time Entry
Delete a time entry. Returns the deleted entry. Use hubplanner_time_entry_delete to remove a wrong entry.
- Idempotent
Inputs
time_entry_idstringrequired- ID of the time entry. Example: 5d414b23c0881e733f85f419.
hubplanner_vacation_deleteDelete a vacation entry.DestructiveDelete Vacation
Delete a vacation entry. Returns the deleted vacation. Use hubplanner_vacation_delete to cancel time off.
- Idempotent
Inputs
vacation_idstringrequired- ID of the vacation. Example: 5d414b23c0881e733f85f419.
No tools match.