Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Teamleader Focus

Scalekit connector
Open markdown

The Teamleader Focus connector lets your AI agent act in each user's Teamleader Focus account. Each user signs in to Teamleader Focus once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 30 tools.

Tools
30
What they doRead · write · destructive
14 · 14 · 214 read14 write2 destructive
Users sign in with
OAuth app
Your own Teamleader Focus app

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 Teamleader Focus connection

    In AgentKit > Connections, create a Teamleader Focus connection and copy its redirect URI. The name you give it is the connection_name your code passes. See Configure connections.

  4. Register an OAuth app

    Teamleader Focus connections use your own OAuth app. Register one with Teamleader Focus and add the redirect URI you copied.

    Then enter the app's Client ID and Client Secret on the Teamleader Focus connection.

  5. 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 = 'teamleader'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Teamleader Focus:', 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: 'teamleader_user_me',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • teamleader_companies_listList or search companies in Teamleader Focus, optionally by tag, VAT number or search term.Read-only

    List Companies

    List or search companies in Teamleader Focus, optionally by tag, VAT number or search term. Returns each company's id, name, vat_number, emails, telephones, website, tags and added_at. Use this to find a company. Use teamleader_company_get for full details.

    Inputs

    page_numberinteger
    Page to return, starting at 1. Example: 2
    page_sizeinteger
    Number of results per page (default 20, max 100). Example: 50
    sort_fieldstring
    Field to sort by: name, added_at, updated_at. Example: nameone of nameadded_atupdated_at
    sort_orderstring
    Sort direction: asc or desc. Example: descone of ascdesc
    tagsarray
    Only companies with all these tags. Example: ["customer"]
    termstring
    Search text matched against name, VAT number, email and phone. Example: acme
    updated_sincestring
    Only companies changed since this time (ISO 8601). Example: 2026-11-01T00:00:00+00:00
    vat_numberstring
    Only the company with this VAT number. Example: BE0899623035
  • teamleader_company_getGet one Teamleader Focus company by ID.Read-only

    Get Company

    Get one Teamleader Focus company by ID. Returns the full company: name, VAT number, emails, telephones, addresses, responsible user, tags, custom fields and remarks. Use this when you know the company ID. Use teamleader_companies_list to search.

    Inputs

    idstringrequired
    ID of the company. Get it from teamleader_companies_list. Example: f29abf48-337d-44b4-aad4-585f5277a456
  • teamleader_contact_getGet one Teamleader Focus contact by ID.Read-only

    Get Contact

    Get one Teamleader Focus contact by ID. Returns the full contact: name, emails, telephones, addresses, linked companies, tags, custom fields and remarks. Use this when you know the contact ID. Use teamleader_contacts_list to search.

    Inputs

    idstringrequired
    ID of the contact. Get it from teamleader_contacts_list. Example: f29abf48-337d-44b4-aad4-585f5277a456
  • teamleader_contacts_listList or search contacts (people) in Teamleader Focus, optionally by company, tag or search term.Read-only

    List Contacts

    List or search contacts (people) in Teamleader Focus, optionally by company, tag or search term. Returns each contact's id, first_name, last_name, emails, telephones, tags and added_at. Use this to find a contact. Use teamleader_contact_get for one contact's full details.

    Inputs

    company_idstring
    Only contacts linked to this company. Example: f29abf48-337d-44b4-aad4-585f5277a456
    page_numberinteger
    Page to return, starting at 1. Example: 2
    page_sizeinteger
    Number of results per page (default 20, max 100). Example: 50
    sort_fieldstring
    Field to sort by: added_at, name, updated_at. Example: updated_atone of added_atnameupdated_at
    sort_orderstring
    Sort direction: asc or desc. Example: descone of ascdesc
    tagsarray
    Only contacts with all these tags. Example: ["prospect"]
    termstring
    Search text matched against name, email, phone and VAT. Example: acme
    updated_sincestring
    Only contacts changed since this time (ISO 8601). Example: 2026-11-01T00:00:00+00:00
  • teamleader_deal_getGet one Teamleader Focus deal by ID.Read-only

    Get Deal

    Get one Teamleader Focus deal by ID. Returns its title, summary, status, lead, estimated value and probability, current phase, phase history, quotations and custom fields. Use this when you know the deal ID. Use teamleader_deals_list to search.

    Inputs

    idstringrequired
    ID of the deal. Get it from teamleader_deals_list. Example: f29abf48-337d-44b4-aad4-585f5277a456
  • teamleader_deal_phases_listList the phases of the deal pipelines in Teamleader Focus.Read-only

    List Deal Phases

    List the phases of the deal pipelines in Teamleader Focus. Returns each phase's id, name, pipeline, probability and follow-up actions. Use this to find a phase_id before teamleader_deal_move or teamleader_deal_create.

    Inputs

    deal_pipeline_idstring
    Only phases of this pipeline. Example: f29abf48-337d-44b4-aad4-585f5277a456
    page_numberinteger
    Page to return, starting at 1. Example: 2
    page_sizeinteger
    Number of results per page (default 20, max 100). Example: 50
  • teamleader_deals_listList or search deals in Teamleader Focus, optionally by customer, phase, responsible user or closing date.Read-only

    List Deals

    List or search deals in Teamleader Focus, optionally by customer, phase, responsible user or closing date. Returns each deal's id, title, reference, status, lead (customer), estimated_value, current_phase, responsible_user and dates. Use this to browse the pipeline. Use teamleader_deal_get for one deal.

    Inputs

    customer_idstring
    ID of the contact or company. Needed together with customer_type. Example: f29abf48-337d-44b4-aad4-585f5277a456
    customer_typestring
    Type of customer: contact or company. Needed together with customer_id. Example: companyone of contactcompany
    estimated_closing_date_fromstring
    Only deals expected to close on or after this date, YYYY-MM-DD. Example: 2026-11-01
    estimated_closing_date_untilstring
    Only deals expected to close on or before this date, YYYY-MM-DD. Example: 2026-12-31
    page_numberinteger
    Page to return, starting at 1. Example: 2
    page_sizeinteger
    Number of results per page (default 20, max 100). Example: 50
    phase_idstring
    Only deals in this phase. Get phases from teamleader_deal_phases_list. Example: 1758e847-cc1f-04ce-bd17-5a852e8c01b4
    responsible_user_idstring
    Only deals owned by this user. Example: f29abf48-337d-44b4-aad4-585f5277a456
    sort_fieldstring
    Field to sort by: created_at, weighted_value. Example: created_atone of created_atweighted_value
    sort_orderstring
    Sort direction: asc or desc. Example: descone of ascdesc
    termstring
    Search text matched against deal title, reference and customer name. Example: acme
  • teamleader_events_listList calendar events in Teamleader Focus within a time range, optionally for one user or linked record.Read-only

    List Calendar Events

    List calendar events in Teamleader Focus within a time range, optionally for one user or linked record. Returns each event's id, title, description, starts_at, ends_at, location, activity type, attendees and links. Use this to check a schedule. Use teamleader_event_create to book a new event.

    Inputs

    ends_afterstring
    Only events ending after this time (ISO 8601). Example: 2026-11-16T00:00:00+01:00
    page_numberinteger
    Page to return, starting at 1. Example: 2
    page_sizeinteger
    Number of results per page (default 20, max 100). Example: 50
    sort_orderstring
    Sort direction: asc or desc. Example: descone of ascdesc
    starts_beforestring
    Only events starting before this time (ISO 8601). Example: 2026-11-23T00:00:00+01:00
    termstring
    Search text matched against the event title and description. Example: acme
    user_idstring
    Only events of this user. Example: f29abf48-337d-44b4-aad4-585f5277a456