Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Certifier

Scalekit connector
Open markdown

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

Tools
19
What they doRead · write · destructive
9 · 8 · 29 read8 write2 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 Certifier connection

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

    Each user opens the link once and enters their Certifier 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
  • certifier_credential_designs_getGet the ordered design templates used by a credential, with preview URLs for each.Read-only

    Get Credential Designs

    Get the ordered design templates used by a credential, with preview URLs for each. Returns each design's ID, type and versioned PNG/PDF preview URLs (the URLs change when the design or a shown attribute changes). Use this to get a shareable image or PDF of a credential.

    Inputs

    credential_idstringrequired
    Credential ID. Get it from certifier_credentials_list, certifier_credentials_search or the create response. Example: 01hrsvjp560yksep2a3bek3z97.
  • certifier_credential_getGet one Certifier credential by ID.Read-only

    Get Credential

    Get one Certifier credential by ID. Returns id, publicId, groupId, status (draft, issued, expired), recipient, issueDate, expiryDate, attributes and customAttributes. Use this to check a credential's status. Use certifier_credential_designs_get for preview images.

    Inputs

    credential_idstringrequired
    Credential ID. Get it from certifier_credentials_list, certifier_credentials_search or the create response. Example: 01hrsvjp560yksep2a3bek3z97.
  • certifier_credential_interactions_listList credential interaction events (views, shares, downloads, verifications), optionally for one credential.Read-only

    List Credential Interactions

    List credential interaction events (views, shares, downloads, verifications), optionally for one credential. Returns data with each event's id, credentialId, eventType, triggeredBy and triggeredAt, plus pagination.next. Use this to see engagement with credentials.

    Inputs

    credential_idstring
    Only events for this credential ID. Example: 01hrsvjp560yksep2a3bek3z97.
    cursorstring
    Pagination cursor: pagination.next from the previous response. Example: 01hrsvjp560yksep2a3bek3z97.
    limitinteger
    Items to return, up to 100. Certifier defaults to 20. Example: 20.
  • certifier_credential_template_getGet one credential template (group) by ID.Read-only

    Get Credential Template

    Get one credential template (group) by ID. Returns its id, name, designIds, learningEventUrl and timestamps. Use certifier_credential_templates_list to find IDs.

    Inputs

    template_idstringrequired
    Credential template (group) ID. Get it from certifier_credential_templates_list. Example: 01g90279gp5sbmfek7wymcsvec.
  • certifier_credential_templates_listList the credential templates (also called groups) in your Certifier workspace.Read-only

    List Credential Templates

    List the credential templates (also called groups) in your Certifier workspace. Returns data with each template's id, name, designIds and learningEventUrl, plus pagination.next. Use this to find the template ID needed to create credentials.

    Inputs

    cursorstring
    Pagination cursor: pagination.next from the previous response. Example: 01hrsvjp560yksep2a3bek3z97.
    limitinteger
    Items to return, up to 100. Certifier defaults to 20. Example: 20.
  • certifier_credentials_listList the credentials (certificates and badges) in your Certifier workspace, newest first, with cursor pagination.Read-only

    List Credentials

    List the credentials (certificates and badges) in your Certifier workspace, newest first, with cursor pagination. Returns data with each credential's id, publicId, groupId, status, recipient, issueDate, expiryDate and attributes, plus pagination.next. Use this to browse. Use certifier_credentials_search to filter by status, recipient, template or dates.

    Inputs

    cursorstring
    Pagination cursor: pagination.next from the previous response. Example: 01hrsvjp560yksep2a3bek3z97.
    limitinteger
    Items to return, up to 100. Certifier defaults to 20. Example: 20.
  • certifier_design_template_getGet one design template by ID.Read-only

    Get Design Template

    Get one design template by ID. Returns the design's id, name, type and preview details. Use certifier_design_templates_list to find IDs.

    Inputs

    design_idstringrequired
    Design template ID from certifier_design_templates_list. Example: 01fpwtztwf7sacca5r0c483mnm.