Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Connecteam

Scalekit connector
Open markdown

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

Tools
59
What they doRead · write · destructive
32 · 21 · 632 read21 write6 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 Connecteam connection

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

    Each user opens the link once and enters their Connecteam 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
  • connecteam_account_getGet the Connecteam company account the API key belongs to.Read-only

    Get Account

    Get the Connecteam company account the API key belongs to. Returns data (companyName, companyId). Use this to confirm the connection and see the company ID and name.

    Inputs

    This tool takes no inputs.

  • connecteam_conversations_listList chat conversations (teams and channels) in the account.Read-only

    List Conversations

    List chat conversations (teams and channels) in the account. Returns data (conversations). Use this to get a conversation ID for connecteam_conversation_message_send.

    Inputs

    limitinteger
    The maximum number of results to display per page. Example: 50
    offsetinteger
    The resource offset of the last successfully read resource will be returned as the paging.offset JSON property of a paginated response containing more results. Example: 0
  • connecteam_daily_note_getGet one daily note by ID.Read-only

    Get Daily Note

    Get one daily note by ID. Returns data (id, title, qualifiedUserIds, qualifiedGroupIds, dates). Use this after connecteam_daily_note_create.

    Inputs

    note_idintegerrequired
    The unique identifier of the note. Example: 64f1c2a9e4b0a1b2c3d4e605
  • connecteam_documents_listList the company document templates.Read-only

    List Documents

    List the company document templates. Returns data (documents). Use this to see which documents can be pushed to users.

    Inputs

    document_idsarray
    Only include these document ids. Example: [12345]
    limitinteger
    The maximum number of results to display per page. Example: 50
    offsetinteger
    The resource offset of the last successfully read resource will be returned as the paging.offset JSON property of a paginated response containing more results. Example: 0
  • connecteam_form_getGet one form with its questions.Read-only

    Get Form

    Get one form with its questions. Returns data (formId, formName, createdAt, lastUpdatedAt, questions, settings). Get the form ID from connecteam_forms_list.

    Inputs

    form_idintegerrequired
    Form id to return. Example: 4455667
  • connecteam_form_submission_getGet one form submission with all its answers.Read-only

    Get Form Submission

    Get one form submission with all its answers. Returns data (formSubmission). Get the IDs from connecteam_form_submissions_list.

    Inputs

    form_idintegerrequired
    Form Id. Example: 4455667
    form_submission_idstringrequired
    Filter by Form submission id. Example: 64f1c2a9e4b0a1b2c3d4e600
  • connecteam_form_submissions_listList submissions of a form, optionally by user or submission time.Read-only

    List Form Submissions

    List submissions of a form, optionally by user or submission time. Returns data (formSubmissions). Use connecteam_form_submission_get for one submission's answers.

    Inputs

    form_idintegerrequired
    Filter by Form Id. Example: 4455667
    limitinteger
    The maximum number of results to display per page. Example: 50
    offsetinteger
    The resource offset of the last successfully read resource will be returned as the paging.offset JSON property of a paginated response containing more results. Example: 0
    submitting_end_timeinteger
    Filter form submissions that were submitted until this timestamp. Example: 10
    submitting_start_timestampinteger
    Filter form submissions that were submitted from this timestamp. Example: 10
    user_idsarray
    Filter by submitting user ids. Example: [1203456]
  • connecteam_forms_listList the forms (checklists, reports, surveys) in the account.Read-only

    List Forms

    List the forms (checklists, reports, surveys) in the account. Returns data (forms). Use this to get a form ID for connecteam_form_submissions_list.

    Inputs

    end_datestring
    Filter forms created on or before this date (form creation date) in ISO 8601 format (YYYY-MM-DD). Inclusive. Example: 2026-02-03
    limitinteger
    The maximum number of results to display per page. Example: 50
    namestring
    The name of the form to filter by (partial, case-insensitive match) Example: Example name
    offsetinteger
    The resource offset of the last successfully read resource will be returned as the paging.offset JSON property of a paginated response containing more results. Example: 0
    start_datestring
    Filter forms created on or after this date (form creation date) in ISO 8601 format (YYYY-MM-DD). Inclusive. Example: 2026-02-02