> **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 Certifier

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.

**Authentication:** Bearer Token
**Categories:** Productivity
**Tools:** 19: 9 read, 8 write, 2 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=CERTIFIER)

## 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 Certifier connection

   In **AgentKit > Connections**, create a Certifier connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### 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 = '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)
   ```

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

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

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

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Certifier credentials there. 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: 'certifier_credential_designs_get',
  toolInput: {
    credential_id: '<credential_id>',
  },
  connector: 'certifier',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="certifier_credential_designs_get",
    tool_input={
        "credential_id": "<credential_id>",
    },
    connection_name="certifier",
    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.

### `certifier_credential_designs_get`

Get Credential Designs · Read-only

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.

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

Inputs:

- `credential_id` (`string`, required): Credential ID. Get it from certifier_credentials_list, certifier_credentials_search or the create response. Example: 01hrsvjp560yksep2a3bek3z97.

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

### `certifier_credential_get`

Get Credential · Read-only

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.

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

Inputs:

- `credential_id` (`string`, required): Credential ID. Get it from certifier_credentials_list, certifier_credentials_search or the create response. Example: 01hrsvjp560yksep2a3bek3z97.

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

### `certifier_credential_interactions_list`

List Credential Interactions · Read-only

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.

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

Inputs:

- `credential_id` (`string`, optional): Only events for this credential ID. Example: 01hrsvjp560yksep2a3bek3z97.
- `cursor` (`string`, optional): Pagination cursor: pagination.next from the previous response. Example: 01hrsvjp560yksep2a3bek3z97.
- `limit` (`integer`, optional): Items to return, up to 100. Certifier defaults to 20. Example: 20.

Example input: `{}`

### `certifier_credential_template_get`

Get Credential Template · Read-only

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

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

Inputs:

- `template_id` (`string`, required): Credential template (group) ID. Get it from certifier_credential_templates_list. Example: 01g90279gp5sbmfek7wymcsvec.

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

### `certifier_credential_templates_list`

List Credential Templates · Read-only

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.

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

Inputs:

- `cursor` (`string`, optional): Pagination cursor: pagination.next from the previous response. Example: 01hrsvjp560yksep2a3bek3z97.
- `limit` (`integer`, optional): Items to return, up to 100. Certifier defaults to 20. Example: 20.

Example input: `{}`

### `certifier_credentials_list`

List Credentials · Read-only

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.

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

Inputs:

- `cursor` (`string`, optional): Pagination cursor: pagination.next from the previous response. Example: 01hrsvjp560yksep2a3bek3z97.
- `limit` (`integer`, optional): Items to return, up to 100. Certifier defaults to 20. Example: 20.

Example input: `{}`

### `certifier_credentials_search`

Search Credentials · Read-only

Search credentials with structured filters (AND, OR, NOT) on status, recipient, template and dates, with sorting and pagination.
Returns matching credentials in data plus pagination.next.
Use this to find credentials by recipient email, status or template. Use certifier_credentials_list for an unfiltered list.

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

Inputs:

- `cursor` (`string`, optional): Pagination cursor: pagination.next from the previous response. Example: 01hrsvjp560yksep2a3bek3z97.
- `filter` (`object`, optional): Filter conditions. Fields: id, publicId, groupId, status, recipientId, recipient.name, recipient.email, issueDate, expiryDate, createdAt, updatedAt. Use operators such as equals, contains, endsWith, in, gt, lt, and combine conditions with AND, OR or NOT arrays. Example: {"AND": [{"status": {"equals": "issued"}}, {"recipient": {"email": {"endsWith": "@company.com"}}}]}
- `limit` (`integer`, optional): Items to return. Certifier defaults to 20. Example: 25.
- `sort` (`object`, optional): Sort order: property (id, createdAt, updatedAt, issueDate or expiryDate) and order (asc or desc). Example: {"property": "createdAt", "order": "desc"}

Example input: `{}`

### `certifier_design_template_get`

Get Design Template · Read-only

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

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

Inputs:

- `design_id` (`string`, required): Design template ID from certifier_design_templates_list. Example: 01fpwtztwf7sacca5r0c483mnm.

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

### `certifier_design_templates_list`

List Design Templates · Read-only

List the certificate and badge design templates in your Certifier workspace.
Returns data with each design's id, name, type (certificate or badge) and preview, plus pagination.next.
Use this to get design IDs for certifier_credential_template_create.

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

Inputs:

- `cursor` (`string`, optional): Pagination cursor: pagination.next from the previous response. Example: 01hrsvjp560yksep2a3bek3z97.
- `limit` (`integer`, optional): Items to return, up to 100. Certifier defaults to 20. Example: 20.

Example input: `{}`

### `certifier_credential_create`

Create Draft Credential · Write

Create a draft credential for a recipient under a credential template. It is not issued or sent yet.
Returns the new credential with id and status draft.
Then call certifier_credential_issue and certifier_credential_send. Use certifier_credential_create_issue_send to do all three at once.

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

Inputs:

- `recipient_name` (`string`, required): Full name of the recipient, as printed on the credential. Example: John Doe.
- `template_id` (`string`, required): ID of the credential template (group) to issue under. Get it from certifier_credential_templates_list. Example: 01g90279gp5sbmfek7wymcsvec.
- `custom_attributes` (`object`, optional): Custom attribute values keyed by attribute tag (for example custom.mentor), each a text value shown on the design. Example: {"custom.mentor": "Jane Doe"}
- `expiry_date` (`string`, optional): Issuer-claimed expiry date, YYYY-MM-DD. Leave out to use the template's expiration period (or never expire when none is set). Example: 2028-01-15.
- `issue_date` (`string`, optional): Issuer-claimed issue date, YYYY-MM-DD. Leave out to use the UTC date at issuance. Example: 2026-01-15.
- `recipient_email` (`string`, optional): Email address of the recipient; needed to send the credential by email. Example: john.doe@example.com.

Example input: `{"recipient_name":"<recipient_name>","template_id":"<template_id>"}`

### `certifier_credential_create_issue_send`

Create, Issue and Send Credential · Write

Create a credential, issue it and email it to the recipient in one step.
Returns the issued credential with id, publicId and status.
Use this for the usual case. The recipient gets an email using the template's email settings, so recipient_email is needed.

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

Inputs:

- `recipient_name` (`string`, required): Full name of the recipient, as printed on the credential. Example: John Doe.
- `template_id` (`string`, required): ID of the credential template (group) to issue under. Get it from certifier_credential_templates_list. Example: 01g90279gp5sbmfek7wymcsvec.
- `custom_attributes` (`object`, optional): Custom attribute values keyed by attribute tag (for example custom.mentor), each a text value shown on the design. Example: {"custom.mentor": "Jane Doe"}
- `expiry_date` (`string`, optional): Issuer-claimed expiry date, YYYY-MM-DD. Leave out to use the template's expiration period (or never expire when none is set). Example: 2028-01-15.
- `issue_date` (`string`, optional): Issuer-claimed issue date, YYYY-MM-DD. Leave out to use the UTC date at issuance. Example: 2026-01-15.
- `recipient_email` (`string`, optional): Email address of the recipient; needed to send the credential by email. Example: john.doe@example.com.

Example input: `{"recipient_name":"<recipient_name>","template_id":"<template_id>"}`

### `certifier_credential_interaction_create`

Record Credential Interaction · Write

Record an interaction event on a credential, for example when you show or share credentials in your own app.
Returns the new interaction event.
Use this only to track events that happen outside Certifier's own pages.

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

Inputs:

- `credential_id` (`string`, required): ID of the credential the event belongs to. Example: 01hrsvjp560yksep2a3bek3z97.
- `event_type` (`string`, required): Type of interaction. Example: credential_viewed. One of: `credential_viewed`, `credential_shared_to_linkedin`, `credential_added_to_linkedin_profile`, `credential_shared_to_facebook`, `credential_shared_to_twitter`, `credential_shared_to_messenger`, `credential_shared_to_whatsapp`, `credential_shared_to_pinterest`, `credential_shared_to_telegram`, `credential_shared_to_weibo`, `credential_downloaded`, `credential_link_copied`, `credential_verified`.
- `triggered_at` (`string`, required): When it happened, ISO 8601 date-time. Example: 2026-03-12T17:33:05.784Z.
- `triggered_by` (`string`, required): Who did it: recipient or guest. Example: recipient. One of: `recipient`, `guest`.

Example input: `{"credential_id":"<credential_id>","event_type":"credential_viewed","triggered_at":"<triggered_at>","triggered_by":"recipient"}`

### `certifier_credential_issue`

Issue Credential · Write

Issue a draft credential, changing its status from draft to issued so it is live in the digital wallet.
Returns the issued credential.
Only works on drafts. Call certifier_credential_send next to email it.

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

Inputs:

- `credential_id` (`string`, required): Credential ID. Get it from certifier_credentials_list, certifier_credentials_search or the create response. Example: 01hrsvjp560yksep2a3bek3z97.

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

### `certifier_credential_send`

Send Credential · Write

Email an issued credential to its recipient using the template's email settings.
Returns the credential.
Only works on issued credentials with a recipient email. Use certifier_credential_issue first for drafts.

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

Inputs:

- `credential_id` (`string`, required): Credential ID. Get it from certifier_credentials_list, certifier_credentials_search or the create response. Example: 01hrsvjp560yksep2a3bek3z97.
- `delivery_method` (`string`, required): How to deliver it. email is the only method. Example: email. One of: `email`.

Example input: `{"credential_id":"<credential_id>","delivery_method":"email"}`

### `certifier_credential_template_create`

Create Credential Template · Write

Create a credential template (group) that ties a name to one or more certificate or badge designs.
Returns the new template with its id.
Use certifier_design_templates_list to get design IDs first.

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

Inputs:

- `design_ids` (`array`, required): Ordered list of at least one design template ID, from certifier_design_templates_list. Example: ["01fpwtztwf7sacca5r0c483mnm"]
- `name` (`string`, required): Template name, shown on credentials as group.name. Example: Financial Markets.
- `learning_event_url` (`string`, optional): URL of the course or event, shown in the digital wallet. Example: https://www.coursera.org/learn/financial-markets-global.

Example input: `{"design_ids":["01fpwtztwf7sacca5r0c483mnm"],"name":"<name>"}`

### `certifier_credential_template_update`

Update Credential Template · Write

Update a credential template's name, designs or learning event URL. Fields you leave out stay unchanged.
Returns the updated template.
design_ids replaces the whole design list.

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

Inputs:

- `template_id` (`string`, required): Credential template (group) ID. Get it from certifier_credential_templates_list. Example: 01g90279gp5sbmfek7wymcsvec.
- `design_ids` (`array`, optional): New ordered list of design template IDs; replaces the current list. Example: ["01fpwtztwf7sacca5r0c483mnm"]
- `learning_event_url` (`string`, optional): New course or event URL. Example: https://example.com/course.
- `name` (`string`, optional): New template name. Example: Financial Markets 2026.

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

### `certifier_credential_update`

Update Credential · Write

Update a credential's recipient, dates or custom attributes. Fields you leave out stay unchanged.
Returns the updated credential.
Use this to fix a name or date. An issued credential cannot clear its issue date.

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

Inputs:

- `credential_id` (`string`, required): Credential ID. Get it from certifier_credentials_list, certifier_credentials_search or the create response. Example: 01hrsvjp560yksep2a3bek3z97.
- `custom_attributes` (`object`, optional): Custom attribute values keyed by attribute tag (for example custom.mentor), each a text value shown on the design. Example: {"custom.mentor": "Jane Doe"}
- `expiry_date` (`string`, optional): Issuer-claimed expiry date, YYYY-MM-DD. Leave out to use the template's expiration period (or never expire when none is set). Example: 2028-01-15.
- `issue_date` (`string`, optional): Issuer-claimed issue date, YYYY-MM-DD. Leave out to use the UTC date at issuance. Example: 2026-01-15.
- `recipient` (`object`, optional): New recipient details: name and/or email. Example: {"name": "John Doe", "email": "john.doe@example.com"}

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

### `certifier_credential_delete`

Delete Credential · Destructive

Permanently delete a credential. This cannot be undone.
Returns no content on success.
Use this to remove a credential issued by mistake.

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

Inputs:

- `credential_id` (`string`, required): Credential ID. Get it from certifier_credentials_list, certifier_credentials_search or the create response. Example: 01hrsvjp560yksep2a3bek3z97.

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

### `certifier_credential_template_delete`

Delete Credential Template · Destructive

Permanently delete a credential template (group). This cannot be undone.
Returns no content on success.
Use this to remove an unused template.

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

Inputs:

- `template_id` (`string`, required): Credential template (group) ID. Get it from certifier_credential_templates_list. Example: 01g90279gp5sbmfek7wymcsvec.

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

## Related

Other Productivity connectors ([all 203](/agentkit/connectors/?category=productivity)):

- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Google Workspace (DWD)](/agentkit/connectors/googledwd/): Scalekit connector, Service account, 100 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 |
