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

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.

**Authentication:** OAuth 2.0
**Categories:** CRM & Sales, Project Management
**Tools:** 30: 14 read, 14 write, 2 destructive
**Users sign in with:** OAuth
**OAuth app:** Your own Teamleader Focus app
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=TEAMLEADER)

## 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 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](/agentkit/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

   **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 = '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)
   ```

   ```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 = "teamleader"
   identifier = "user_123"

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

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

   ```bash
   python quickstart.py
   ```

   Each user signs in once. 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: 'teamleader_companies_list',
  toolInput: {},
  connector: 'teamleader',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="teamleader_companies_list",
    tool_input={},
    connection_name="teamleader",
    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.

### `teamleader_companies_list`

List Companies · Read-only

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.

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

Inputs:

- `page_number` (`integer`, optional): Page to return, starting at 1. Example: 2
- `page_size` (`integer`, optional): Number of results per page (default 20, max 100). Example: 50
- `sort_field` (`string`, optional): Field to sort by: name, added_at, updated_at. Example: name. One of: `name`, `added_at`, `updated_at`.
- `sort_order` (`string`, optional): Sort direction: asc or desc. Example: desc. One of: `asc`, `desc`.
- `tags` (`array`, optional): Only companies with all these tags. Example: ["customer"]
- `term` (`string`, optional): Search text matched against name, VAT number, email and phone. Example: acme
- `updated_since` (`string`, optional): Only companies changed since this time (ISO 8601). Example: 2026-11-01T00:00:00+00:00
- `vat_number` (`string`, optional): Only the company with this VAT number. Example: BE0899623035

Example input: `{}`

### `teamleader_company_get`

Get Company · Read-only

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.

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

Inputs:

- `id` (`string`, required): ID of the company. Get it from teamleader_companies_list. Example: f29abf48-337d-44b4-aad4-585f5277a456

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

### `teamleader_contact_get`

Get Contact · Read-only

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.

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

Inputs:

- `id` (`string`, required): ID of the contact. Get it from teamleader_contacts_list. Example: f29abf48-337d-44b4-aad4-585f5277a456

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

### `teamleader_contacts_list`

List Contacts · Read-only

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.

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

Inputs:

- `company_id` (`string`, optional): Only contacts linked to this company. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `page_number` (`integer`, optional): Page to return, starting at 1. Example: 2
- `page_size` (`integer`, optional): Number of results per page (default 20, max 100). Example: 50
- `sort_field` (`string`, optional): Field to sort by: added_at, name, updated_at. Example: updated_at. One of: `added_at`, `name`, `updated_at`.
- `sort_order` (`string`, optional): Sort direction: asc or desc. Example: desc. One of: `asc`, `desc`.
- `tags` (`array`, optional): Only contacts with all these tags. Example: ["prospect"]
- `term` (`string`, optional): Search text matched against name, email, phone and VAT. Example: acme
- `updated_since` (`string`, optional): Only contacts changed since this time (ISO 8601). Example: 2026-11-01T00:00:00+00:00

Example input: `{}`

### `teamleader_deal_get`

Get Deal · Read-only

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.

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

Inputs:

- `id` (`string`, required): ID of the deal. Get it from teamleader_deals_list. Example: f29abf48-337d-44b4-aad4-585f5277a456

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

### `teamleader_deal_phases_list`

List Deal Phases · Read-only

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.

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

Inputs:

- `deal_pipeline_id` (`string`, optional): Only phases of this pipeline. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `page_number` (`integer`, optional): Page to return, starting at 1. Example: 2
- `page_size` (`integer`, optional): Number of results per page (default 20, max 100). Example: 50

Example input: `{}`

### `teamleader_deals_list`

List Deals · Read-only

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.

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

Inputs:

- `customer_id` (`string`, optional): ID of the contact or company. Needed together with customer_type. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `customer_type` (`string`, optional): Type of customer: contact or company. Needed together with customer_id. Example: company. One of: `contact`, `company`.
- `estimated_closing_date_from` (`string`, optional): Only deals expected to close on or after this date, YYYY-MM-DD. Example: 2026-11-01
- `estimated_closing_date_until` (`string`, optional): Only deals expected to close on or before this date, YYYY-MM-DD. Example: 2026-12-31
- `page_number` (`integer`, optional): Page to return, starting at 1. Example: 2
- `page_size` (`integer`, optional): Number of results per page (default 20, max 100). Example: 50
- `phase_id` (`string`, optional): Only deals in this phase. Get phases from teamleader_deal_phases_list. Example: 1758e847-cc1f-04ce-bd17-5a852e8c01b4
- `responsible_user_id` (`string`, optional): Only deals owned by this user. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `sort_field` (`string`, optional): Field to sort by: created_at, weighted_value. Example: created_at. One of: `created_at`, `weighted_value`.
- `sort_order` (`string`, optional): Sort direction: asc or desc. Example: desc. One of: `asc`, `desc`.
- `term` (`string`, optional): Search text matched against deal title, reference and customer name. Example: acme

Example input: `{}`

### `teamleader_events_list`

List Calendar Events · Read-only

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.

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

Inputs:

- `ends_after` (`string`, optional): Only events ending after this time (ISO 8601). Example: 2026-11-16T00:00:00+01:00
- `page_number` (`integer`, optional): Page to return, starting at 1. Example: 2
- `page_size` (`integer`, optional): Number of results per page (default 20, max 100). Example: 50
- `sort_order` (`string`, optional): Sort direction: asc or desc. Example: desc. One of: `asc`, `desc`.
- `starts_before` (`string`, optional): Only events starting before this time (ISO 8601). Example: 2026-11-23T00:00:00+01:00
- `term` (`string`, optional): Search text matched against the event title and description. Example: acme
- `user_id` (`string`, optional): Only events of this user. Example: f29abf48-337d-44b4-aad4-585f5277a456

Example input: `{}`

### `teamleader_invoice_get`

Get Invoice · Read-only

Get one Teamleader Focus invoice by ID.
Returns its number, dates, status, customer, grouped line items, totals, payments and payment reference.
Use this for one invoice's details. Use teamleader_invoices_list to search.

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

Inputs:

- `id` (`string`, required): ID of the invoice. Get it from teamleader_invoices_list. Example: f29abf48-337d-44b4-aad4-585f5277a456

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

### `teamleader_invoices_list`

List Invoices · Read-only

List invoices in Teamleader Focus, optionally by customer, deal, status or date.
Returns each invoice's id, invoice_number, invoice_date, status, due_on, customer, total and paid state.
Use this to check billing. Use teamleader_invoice_get for line items.

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

Inputs:

- `customer_id` (`string`, optional): ID of the contact or company. Needed together with customer_type. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `customer_type` (`string`, optional): Type of customer: contact or company. Needed together with customer_id. Example: company. One of: `contact`, `company`.
- `deal_id` (`string`, optional): Only invoices for this deal. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `invoice_date_after` (`string`, optional): Only invoices dated on or after this date, YYYY-MM-DD. Example: 2026-10-01
- `invoice_date_before` (`string`, optional): Only invoices dated on or before this date, YYYY-MM-DD. Example: 2026-10-31
- `page_number` (`integer`, optional): Page to return, starting at 1. Example: 2
- `page_size` (`integer`, optional): Number of results per page (default 20, max 100). Example: 50
- `sort_field` (`string`, optional): Field to sort by: invoice_number, invoice_date. Example: invoice_date. One of: `invoice_number`, `invoice_date`.
- `sort_order` (`string`, optional): Sort direction: asc or desc. Example: desc. One of: `asc`, `desc`.
- `status` (`array`, optional): Only invoices with these statuses: draft, outstanding, matched. Example: ["outstanding"]
- `term` (`string`, optional): Search text matched against invoice number, purchase order and customer. Example: acme

Example input: `{}`

### `teamleader_notes_list`

List Notes · Read-only

List the notes on a Teamleader Focus record such as a contact, company or deal.
Returns each note's id, content, author and added_at.
Use this to read the history of a record. Use teamleader_note_create to add one.

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

Inputs:

- `subject_id` (`string`, required): ID of the record. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `subject_type` (`string`, required): Type of record: company, contact, deal, invoice, creditNote, meeting, nextgenProject, product or quotation. Example: deal. One of: `company`, `contact`, `creditNote`, `deal`, `invoice`, `meeting`, `nextgenProject`, `product`, `quotation`.
- `page_number` (`integer`, optional): Page to return, starting at 1. Example: 2
- `page_size` (`integer`, optional): Number of results per page (default 20, max 100). Example: 50

Example input: `{"subject_id":"<subject_id>","subject_type":"company"}`

### `teamleader_tasks_list`

List Tasks · Read-only

List tasks in Teamleader Focus, optionally by assignee, customer, completion or due date.
Returns each task's id, title, description, completed, due_on, estimated_duration, assignee, customer and deal.
Use this to see open work. Combine user_id from teamleader_user_me with completed false for the user's own to-dos.

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

Inputs:

- `completed` (`boolean`, optional): true for completed tasks only, false for open tasks only. Example: false
- `customer_id` (`string`, optional): ID of the contact or company. Needed together with customer_type. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `customer_type` (`string`, optional): Type of customer: contact or company. Needed together with customer_id. Example: company. One of: `contact`, `company`.
- `due_by` (`string`, optional): Only tasks due on or before this date, YYYY-MM-DD. Example: 2026-11-30
- `due_from` (`string`, optional): Only tasks due on or after this date, YYYY-MM-DD. Example: 2026-11-01
- `page_number` (`integer`, optional): Page to return, starting at 1. Example: 2
- `page_size` (`integer`, optional): Number of results per page (default 20, max 100). Example: 50
- `sort_field` (`string`, optional): Field to sort by: created_at, due_on. Example: due_on. One of: `created_at`, `due_on`.
- `sort_order` (`string`, optional): Sort direction: asc or desc. Example: desc. One of: `asc`, `desc`.
- `term` (`string`, optional): Search text matched against the task description. Example: acme
- `user_id` (`string`, optional): Only tasks assigned to this user or their teams. Example: f29abf48-337d-44b4-aad4-585f5277a456

Example input: `{}`

### `teamleader_user_me`

Get Current User · Read-only

Get the Teamleader Focus user who authorized the connection.
Returns the user's id, name, email, language, function and account (company) id.
Use this to learn who is connected, for example to filter tasks by user_id.

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

Inputs: none.

Example input: `{}`

### `teamleader_users_list`

List Users · Read-only

List the users of the Teamleader Focus account.
Returns each user's id, first_name, last_name, email, function, language and status.
Use this to find a user ID for assigning deals or tasks.

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

Inputs:

- `page_number` (`integer`, optional): Page to return, starting at 1. Example: 2
- `page_size` (`integer`, optional): Number of results per page (default 20, max 100). Example: 50
- `term` (`string`, optional): Search text matched against name or email. Example: acme

Example input: `{}`

### `teamleader_company_create`

Create Company · Write

Create a company in Teamleader Focus.
Returns the new company's id and type.
Use this to add an organisation. Use teamleader_contact_create for people.

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

Inputs:

- `name` (`string`, required): Company name. Example: Acme NV
- `addresses` (`array`, optional): Addresses, each with a type (primary, invoicing, delivery or visiting) and an address with line_1, postal_code, city and a two-letter country code. Example: [{"type": "primary", "address": {"line_1": "Dok Noord 3A 101", "postal_code": "9000", "city": "Ghent", "country": "BE"}}]
- `business_type_id` (`string`, optional): Legal form ID, from the business types list. Example: fd48d4a3-b9dc-4eac-8071-5889c9f21e5d
- `email` (`string`, optional): Primary email address. Example: info@acme.be
- `language` (`string`, optional): Language code for communication. Example: nl
- `phone` (`string`, optional): Phone number. Example: +32 9 298 05 00
- `remarks` (`string`, optional): Internal remarks (Markdown). Example: Key account
- `responsible_user_id` (`string`, optional): ID of the user who owns this company. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `tags` (`array`, optional): Tags to set on the company. Example: ["customer"]
- `vat_number` (`string`, optional): VAT number. Example: BE0899623035
- `website` (`string`, optional): Website. Example: https://acme.be

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

### `teamleader_company_update`

Update Company · Write

Update a Teamleader Focus company.
Returns no content on success.
Use this to change a company's details. Only the fields you pass are changed; email, phone and tags replace the current values.

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

Inputs:

- `id` (`string`, required): ID of the company. Get it from teamleader_companies_list. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `addresses` (`array`, optional): Addresses, each with a type (primary, invoicing, delivery or visiting) and an address with line_1, postal_code, city and a two-letter country code. Example: [{"type": "primary", "address": {"line_1": "Dok Noord 3A 101", "postal_code": "9000", "city": "Ghent", "country": "BE"}}]
- `business_type_id` (`string`, optional): Legal form ID, from the business types list. Example: fd48d4a3-b9dc-4eac-8071-5889c9f21e5d
- `email` (`string`, optional): Primary email address. Example: info@acme.be
- `language` (`string`, optional): Language code for communication. Example: nl
- `name` (`string`, optional): Company name. Example: Acme NV
- `phone` (`string`, optional): Phone number. Example: +32 9 298 05 00
- `remarks` (`string`, optional): Internal remarks (Markdown). Example: Key account
- `responsible_user_id` (`string`, optional): ID of the user who owns this company. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `tags` (`array`, optional): Tags to set on the company. Example: ["customer"]
- `vat_number` (`string`, optional): VAT number. Example: BE0899623035
- `website` (`string`, optional): Website. Example: https://acme.be

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

### `teamleader_contact_create`

Create Contact · Write

Create a contact (person) in Teamleader Focus.
Returns the new contact's id and type.
Use this to add a person. Use teamleader_company_create for organisations.

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

Inputs:

- `last_name` (`string`, required): Last name. Example: Ruiz
- `addresses` (`array`, optional): Addresses, each with a type (primary, invoicing, delivery or visiting) and an address with line_1, postal_code, city and a two-letter country code. Example: [{"type": "primary", "address": {"line_1": "Dok Noord 3A 101", "postal_code": "9000", "city": "Ghent", "country": "BE"}}]
- `email` (`string`, optional): Primary email address. Example: dana@acme.be
- `first_name` (`string`, optional): First name. Example: Dana
- `language` (`string`, optional): Language code for communication. Example: nl
- `mobile` (`string`, optional): Mobile number. Example: +32 470 12 34 56
- `phone` (`string`, optional): Phone number. Example: +32 9 298 05 00
- `remarks` (`string`, optional): Internal remarks (Markdown). Example: Met at Channel Days
- `tags` (`array`, optional): Tags to set on the record. Example: ["prospect"]
- `website` (`string`, optional): Website. Example: https://acme.be

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

### `teamleader_contact_update`

Update Contact · Write

Update a Teamleader Focus contact.
Returns no content on success.
Use this to change a contact's name, email, phone, tags or addresses. Only the fields you pass are changed; email, phone and tags replace the current values.

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

Inputs:

- `id` (`string`, required): ID of the contact. Get it from teamleader_contacts_list. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `addresses` (`array`, optional): Addresses, each with a type (primary, invoicing, delivery or visiting) and an address with line_1, postal_code, city and a two-letter country code. Example: [{"type": "primary", "address": {"line_1": "Dok Noord 3A 101", "postal_code": "9000", "city": "Ghent", "country": "BE"}}]
- `email` (`string`, optional): Primary email address. Example: dana@acme.be
- `first_name` (`string`, optional): First name. Example: Dana
- `language` (`string`, optional): Language code for communication. Example: nl
- `last_name` (`string`, optional): Last name. Example: Ruiz
- `mobile` (`string`, optional): Mobile number. Example: +32 470 12 34 56
- `phone` (`string`, optional): Phone number. Example: +32 9 298 05 00
- `remarks` (`string`, optional): Internal remarks (Markdown). Example: Met at Channel Days
- `tags` (`array`, optional): Tags to set on the record. Example: ["prospect"]
- `website` (`string`, optional): Website. Example: https://acme.be

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

### `teamleader_deal_create`

Create Deal · Write

Create a deal for a contact or company in Teamleader Focus.
Returns the new deal's id and type.
Use this to add an opportunity. Use teamleader_deal_move to change its phase later.

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

Inputs:

- `customer_id` (`string`, required): ID of the contact or company the deal is for. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `customer_type` (`string`, required): Type of customer the deal is for: contact or company. Needed together with customer_id. Example: company. One of: `contact`, `company`.
- `title` (`string`, required): Title of the deal. Example: Website redesign
- `contact_person_id` (`string`, optional): Contact person at the company customer. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `estimated_closing_date` (`string`, optional): Expected closing date, YYYY-MM-DD. Example: 2026-12-31
- `estimated_probability` (`number`, optional): Estimated win probability between 0 and 1. Example: 0.6
- `estimated_value_amount` (`number`, optional): Estimated deal value. Example: 12500
- `estimated_value_currency` (`string`, optional): Currency of the estimated value. Defaults to EUR. Example: EUR. Default: `EUR`.
- `phase_id` (`string`, optional): Phase to start the deal in; defaults to the first phase of the default pipeline. Example: 060687bb-a742-4882-a538-199a5e5feb60
- `responsible_user_id` (`string`, optional): ID of the user responsible for the deal. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `source_id` (`string`, optional): ID of the deal source. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `summary` (`string`, optional): Remarks for the deal. Example: Needs a proposal by Friday

Example input: `{"customer_id":"<customer_id>","customer_type":"contact","title":"<title>"}`

### `teamleader_deal_lose`

Mark Deal Lost · Write

Mark a Teamleader Focus deal as lost, with an optional reason.
Returns no content on success.
Use this when the deal falls through. Use teamleader_deal_win when it is won.

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

Inputs:

- `id` (`string`, required): ID of the deal. Get it from teamleader_deals_list. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `extra_info` (`string`, optional): Free-text explanation. Example: Decision postponed to next year
- `reason_id` (`string`, optional): ID of the lost reason, from Teamleader's lost reasons. Example: da4c902f-2ae5-4c1f-be6f-b50308aabc5c

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

### `teamleader_deal_move`

Move Deal to Phase · Write

Move a Teamleader Focus deal to another phase of its pipeline.
Returns no content on success.
Use this to advance a deal. Use teamleader_deal_win or teamleader_deal_lose to close it.

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

Inputs:

- `id` (`string`, required): ID of the deal. Get it from teamleader_deals_list. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `phase_id` (`string`, required): Phase to move the deal to. Get it from teamleader_deal_phases_list. Example: 8776abee-d856-43c6-b98d-9ffc912e8b0b

Example input: `{"id":"<id>","phase_id":"<phase_id>"}`

### `teamleader_deal_update`

Update Deal · Write

Update a Teamleader Focus deal: title, customer, value, probability, closing date or owner.
Returns no content on success.
Use this to edit a deal. Use teamleader_deal_move, teamleader_deal_win or teamleader_deal_lose to change its stage.

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

Inputs:

- `id` (`string`, required): ID of the deal. Get it from teamleader_deals_list. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `contact_person_id` (`string`, optional): Contact person at the company customer. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `customer_id` (`string`, optional): ID of the contact or company the deal is for. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `customer_type` (`string`, optional): Type of customer the deal is for: contact or company. Needed together with customer_id. Example: company. One of: `contact`, `company`.
- `estimated_closing_date` (`string`, optional): Expected closing date, YYYY-MM-DD. Example: 2026-12-31
- `estimated_probability` (`number`, optional): Estimated win probability between 0 and 1. Example: 0.6
- `estimated_value_amount` (`number`, optional): Estimated deal value. Example: 12500
- `estimated_value_currency` (`string`, optional): Currency of the estimated value. Defaults to EUR. Example: EUR. Default: `EUR`.
- `responsible_user_id` (`string`, optional): ID of the user responsible for the deal. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `source_id` (`string`, optional): ID of the deal source. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `summary` (`string`, optional): Remarks for the deal. Example: Needs a proposal by Friday
- `title` (`string`, optional): Title of the deal. Example: Website redesign

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

### `teamleader_deal_win`

Mark Deal Won · Write

Mark a Teamleader Focus deal as won.
Returns no content on success.
Use this when the customer accepts. Use teamleader_deal_lose when the deal is lost.

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

Inputs:

- `id` (`string`, required): ID of the deal. Get it from teamleader_deals_list. Example: f29abf48-337d-44b4-aad4-585f5277a456

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

### `teamleader_event_create`

Create Calendar Event · Write

Create a calendar event in Teamleader Focus, with attendees and links to a contact, company or deal.
Returns the new event's id and type.
Use this to book a meeting or call.

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

Inputs:

- `activity_type_id` (`string`, required): ID of the activity type (meeting, call and so on), from Teamleader's activity types. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `ends_at` (`string`, required): End time (ISO 8601 with offset). Example: 2026-11-20T11:00:00+01:00
- `starts_at` (`string`, required): Start time (ISO 8601 with offset). Example: 2026-11-20T10:00:00+01:00
- `title` (`string`, required): Title of the event. Example: Demo with Acme
- `attendees` (`array`, optional): Attendees, each a type (user or contact) and an id. Example: [{"type": "user", "id": "f29abf48-337d-44b4-aad4-585f5277a456"}]
- `description` (`string`, optional): Description. Example: Show the new reporting module
- `links` (`array`, optional): Records to link, each a type (contact, company or deal) and an id. Example: [{"type": "company", "id": "f29abf48-337d-44b4-aad4-585f5277a456"}]
- `location` (`string`, optional): Location. Example: Dok Noord 3A, Ghent

Example input: `{"activity_type_id":"<activity_type_id>","ends_at":"<ends_at>","starts_at":"<starts_at>","title":"<title>"}`

### `teamleader_note_create`

Create Note · Write

Add a note to a Teamleader Focus record such as a contact, company or deal.
Returns the new note's id and type.
Use this to log a call summary or remark on a record.

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

Inputs:

- `content` (`string`, required): Note text (Markdown). Example: Customer asked for a 10% discount.
- `subject_id` (`string`, required): ID of the record. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `subject_type` (`string`, required): Type of record: company, contact, deal, invoice, creditNote, meeting, nextgenProject, product or quotation. Example: deal. One of: `company`, `contact`, `creditNote`, `deal`, `invoice`, `meeting`, `nextgenProject`, `product`, `quotation`.
- `notify_user_ids` (`array`, optional): Users to notify about the note. Example: ["f29abf48-337d-44b4-aad4-585f5277a456"]

Example input: `{"content":"<content>","subject_id":"<subject_id>","subject_type":"company"}`

### `teamleader_task_complete`

Complete Task · Write

Mark a Teamleader Focus task as completed.
Returns no content on success.
Use this when the work is done.

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

Inputs:

- `id` (`string`, required): ID of the task. Get it from teamleader_tasks_list. Example: f29abf48-337d-44b4-aad4-585f5277a456

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

### `teamleader_task_create`

Create Task · Write

Create a task in Teamleader Focus, optionally linked to a customer or deal and assigned to a user.
Returns the new task's id and type.
Use this to schedule follow-up work. Use teamleader_task_complete to finish it.

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

Inputs:

- `due_on` (`string`, required): Due date, YYYY-MM-DD. Example: 2026-11-30
- `title` (`string`, required): Title of the task. Example: Call back about the proposal
- `work_type_id` (`string`, required): ID of the work type (Teamleader requires one on new tasks). Example: 32665afd-1818-0ed3-9e18-a603a3a21b95
- `assignee_user_id` (`string`, optional): ID of the user to assign the task to. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `customer_id` (`string`, optional): ID of the contact or company. Needed together with customer_type. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `customer_type` (`string`, optional): Type of customer: contact or company. Needed together with customer_id. Example: company. One of: `contact`, `company`.
- `deal_id` (`string`, optional): Deal the task belongs to. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `description` (`string`, optional): Task description. Example: Ask about the budget
- `estimated_minutes` (`integer`, optional): Estimated duration in minutes. Example: 30

Example input: `{"due_on":"<due_on>","title":"<title>","work_type_id":"<work_type_id>"}`

### `teamleader_task_update`

Update Task · Write

Update a Teamleader Focus task: title, due date, description, assignee or links.
Returns no content on success.
Use this to reschedule or reassign a task. Use teamleader_task_complete to finish it.

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

Inputs:

- `id` (`string`, required): ID of the task. Get it from teamleader_tasks_list. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `assignee_user_id` (`string`, optional): ID of the user to assign the task to. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `customer_id` (`string`, optional): ID of the contact or company. Needed together with customer_type. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `customer_type` (`string`, optional): Type of customer: contact or company. Needed together with customer_id. Example: company. One of: `contact`, `company`.
- `deal_id` (`string`, optional): Deal the task belongs to. Example: f29abf48-337d-44b4-aad4-585f5277a456
- `description` (`string`, optional): Task description. Example: Ask about the budget
- `due_on` (`string`, optional): Due date, YYYY-MM-DD. Example: 2026-11-30
- `estimated_minutes` (`integer`, optional): Estimated duration in minutes. Example: 30
- `title` (`string`, optional): Title of the task. Example: Call back about the proposal
- `work_type_id` (`string`, optional): ID of the work type (Teamleader requires one on new tasks). Example: 32665afd-1818-0ed3-9e18-a603a3a21b95

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

### `teamleader_company_delete`

Delete Company · Destructive

Delete a company from Teamleader Focus.
Returns no content on success.
Use this to remove an organisation.

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

Inputs:

- `id` (`string`, required): ID of the company. Get it from teamleader_companies_list. Example: f29abf48-337d-44b4-aad4-585f5277a456

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

### `teamleader_contact_delete`

Delete Contact · Destructive

Delete a contact from Teamleader Focus.
Returns no content on success.
Use this to remove a person.

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

Inputs:

- `id` (`string`, required): ID of the contact. Get it from teamleader_contacts_list. Example: f29abf48-337d-44b4-aad4-585f5277a456

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

## Related

Other CRM & Sales connectors ([all 174](/agentkit/connectors/?category=crm-sales)):

- [Salesforce](/agentkit/connectors/salesforce/): Scalekit connector, OAuth, 74 tools
- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Close](/agentkit/connectors/close/): Scalekit connector, OAuth, 103 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 |
