Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Agiled

Scalekit connector
Open markdown

The Agiled connector lets your AI agent act in each user's Agiled account. Each user connects their own Agiled access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

Tools
60
What they doRead · write · destructive
32 · 20 · 832 read20 write8 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 Agiled connection

    In AgentKit > Connections, create an Agiled 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 = 'agiled'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Agiled:', 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: 'agiled_accounts_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Agiled 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
  • agiled_account_getGet one Agiled account by ID, optionally with related records (include).Read-only

    Get Account

    Get one Agiled account by ID, optionally with related records (include). Returns the account's fields. Use agiled_accounts_list to find the ID.

    Inputs

    accountIdstringrequired
    ID of the account (company). Example: 123.
    includestring
    Comma-separated includes. Example: account.
  • agiled_accounts_listList Agiled accounts with filters, sorting, paging and optional related records (include).Read-only

    List Accounts

    List Agiled accounts with filters, sorting, paging and optional related records (include). Returns data[] of accounts and pagination meta. Use agiled_account_get for one account.

    Inputs

    emailstring
    Filter by email. Example: avery@example.com.
    includestring
    Comma-separated includes. Supported: contacts, assigned_user, assigned_users. Example: contacts.
    namestring
    Filter by name. Example: Acme.
    pageinteger
    Page number. Example: 1.
    per_pageinteger
    Items per page, up to 100. Example: 25.
    sort_bystring
    Field to sort by: created_at, updated_at, name, email. Example: created_at.
    sort_directionstring
    Sort direction: asc or desc.one of ascdesc
  • agiled_appointment_getGet one Agiled appointment by ID.Read-only

    Get Appointment

    Get one Agiled appointment by ID. Returns the appointment's time, event type, invitee, status and links. Use agiled_appointments_list to find the ID.

    Inputs

    appointmentIdstringrequired
    ID of the appointment. Example: 123.
    includestring
    Comma-separated includes. Example: account.
  • agiled_appointments_listList Agiled scheduling appointments (bookings) with filters, sorting and paging.Read-only

    List Appointments

    List Agiled scheduling appointments (bookings) with filters, sorting and paging. Returns data[] of appointments with time, event type, invitee and status, and pagination meta. Use agiled_appointment_get for one appointment.

    Inputs

    event_type_idstring
    Filter by event_type_id. Example: evt_123.
    includestring
    Comma-separated includes. Supported: event_type, attendees. Example: event_type.
    pageinteger
    Page number. Example: 1.
    per_pageinteger
    Items per page, up to 100. Example: 25.
    sort_bystring
    Field to sort by: created_at, updated_at, start_time, end_time. Example: created_at.
    sort_directionstring
    Sort direction: asc or desc.one of ascdesc
    statusstring
    Filter by status. Example: open.
    user_idstring
    Filter by user_id. Example: usr_123.
  • agiled_contact_getGet one Agiled contact by ID, optionally with related records (include).Read-only

    Get Contact

    Get one Agiled contact by ID, optionally with related records (include). Returns the contact's fields. Use agiled_contacts_list to find the ID.

    Inputs

    contactIdstringrequired
    ID of the contact. Example: 123.
    includestring
    Comma-separated includes. Example: account.
  • agiled_contacts_listList Agiled contacts with filters, sorting, paging and optional related records (include).Read-only

    List Contacts

    List Agiled contacts with filters, sorting, paging and optional related records (include). Returns data[] of contacts and pagination meta. Use agiled_contact_get for one contact.

    Inputs

    emailstring
    Filter by email. Example: avery@example.com.
    full_namestring
    Filter by full_name. Example: Avery Stone.
    includestring
    Comma-separated includes. Supported: accounts, assigned_user, assigned_users. Example: accounts.
    pageinteger
    Page number. Example: 1.
    per_pageinteger
    Items per page, up to 100. Example: 25.
    sort_bystring
    Field to sort by: created_at, updated_at, first_name, last_name, email. Example: created_at.
    sort_directionstring
    Sort direction: asc or desc.one of ascdesc
  • agiled_deal_getGet one Agiled deal by ID, optionally with related records (include).Read-only

    Get Deal

    Get one Agiled deal by ID, optionally with related records (include). Returns the deal's fields. Use agiled_deals_list to find the ID.

    Inputs

    dealIdstringrequired
    ID of the deal. Example: 123.
    includestring
    Comma-separated includes. Example: account.
  • agiled_deals_listList Agiled deals with filters, sorting, paging and optional related records (include).Read-only

    List Deals

    List Agiled deals with filters, sorting, paging and optional related records (include). Returns data[] of deals and pagination meta. Use agiled_deal_get for one deal.

    Inputs

    includestring
    Comma-separated includes. Supported: account, contacts, assigned_user, assigned_users. Example: account.
    namestring
    Filter by name. Example: Acme.
    pageinteger
    Page number. Example: 1.
    per_pageinteger
    Items per page, up to 100. Example: 25.
    sort_bystring
    Field to sort by: created_at, updated_at, name, status, value. Example: created_at.
    sort_directionstring
    Sort direction: asc or desc.one of ascdesc
    statusstring
    Filter by status. Example: open.