Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to HUB Planner (Resource Flow)

Scalekit connector
Open markdown

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

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  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.

  4. 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.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)
    Terminal window
    npx tsx quickstart.mts

    Each 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 to execute_tool
Try in PlaygroundRequest a tool
  • hubplanner_billing_rates_listList billing rates.Read-only

    List 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-only

    List 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-only

    Get 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-only

    List 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_client_getGet one client by ID.Read-only

    Get 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-only

    List 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-only

    Get 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.