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
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>Create the Certifier connection
In AgentKit > Connections, create a Certifier connection. The name you give it is the
connection_nameyour code passes. See Configure connections.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.actionsconst connector = 'certifier'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'certifier_credential_interactions_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "certifier"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="certifier_credential_interactions_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach 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 toexecute_toolcertifier_credential_designs_getGet the ordered design templates used by a credential, with preview URLs for each.Read-onlyGet 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-onlyGet 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-onlyList 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-onlyGet 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-onlyList 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-onlyList 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_credentials_searchSearch credentials with structured filters (AND, OR, NOT) on status, recipient, template and dates, with sorting and pagination.Read-onlySearch Credentials
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.
Inputs
cursorstring- Pagination cursor: pagination.next from the previous response. Example: 01hrsvjp560yksep2a3bek3z97.
filterobject- 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"}}}]}
limitinteger- Items to return. Certifier defaults to 20. Example: 25.
sortobject- Sort order: property (id, createdAt, updatedAt, issueDate or expiryDate) and order (asc or desc). Example: {"property": "createdAt", "order": "desc"}
certifier_design_template_getGet one design template by ID.Read-onlyGet 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.
certifier_design_templates_listList the certificate and badge design templates in your Certifier workspace.Read-onlyList Design Templates
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.
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_credential_createCreate a draft credential for a recipient under a credential template.WriteCreate Draft Credential
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.
Inputs
recipient_namestringrequired- Full name of the recipient, as printed on the credential. Example: John Doe.
template_idstringrequired- ID of the credential template (group) to issue under. Get it from certifier_credential_templates_list. Example: 01g90279gp5sbmfek7wymcsvec.
custom_attributesobject- 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_datestring- 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_datestring- Issuer-claimed issue date, YYYY-MM-DD. Leave out to use the UTC date at issuance. Example: 2026-01-15.
recipient_emailstring- Email address of the recipient; needed to send the credential by email. Example: john.doe@example.com.
certifier_credential_create_issue_sendCreate a credential, issue it and email it to the recipient in one step.WriteCreate, Issue and Send Credential
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.
Inputs
recipient_namestringrequired- Full name of the recipient, as printed on the credential. Example: John Doe.
template_idstringrequired- ID of the credential template (group) to issue under. Get it from certifier_credential_templates_list. Example: 01g90279gp5sbmfek7wymcsvec.
custom_attributesobject- 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_datestring- 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_datestring- Issuer-claimed issue date, YYYY-MM-DD. Leave out to use the UTC date at issuance. Example: 2026-01-15.
recipient_emailstring- Email address of the recipient; needed to send the credential by email. Example: john.doe@example.com.
certifier_credential_interaction_createRecord an interaction event on a credential, for example when you show or share credentials in your own app.WriteRecord Credential Interaction
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.
Inputs
credential_idstringrequired- ID of the credential the event belongs to. Example: 01hrsvjp560yksep2a3bek3z97.
event_typestringrequired- Type of interaction. Example: credential_viewed.one of
credential_viewedcredential_shared_to_linkedincredential_added_to_linkedin_profilecredential_shared_to_facebookcredential_shared_to_twittercredential_shared_to_messengercredential_shared_to_whatsappcredential_shared_to_pinterestcredential_shared_to_telegramcredential_shared_to_weibocredential_downloadedcredential_link_copiedcredential_verified triggered_atstringrequired- When it happened, ISO 8601 date-time. Example: 2026-03-12T17:33:05.784Z.
triggered_bystringrequired- Who did it: recipient or guest. Example: recipient.one of
recipientguest
certifier_credential_issueIssue a draft credential, changing its status from draft to issued so it is live in the digital wallet.WriteIssue Credential
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.
Inputs
credential_idstringrequired- Credential ID. Get it from certifier_credentials_list, certifier_credentials_search or the create response. Example: 01hrsvjp560yksep2a3bek3z97.
certifier_credential_sendEmail an issued credential to its recipient using the template's email settings.WriteSend Credential
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.
Inputs
credential_idstringrequired- Credential ID. Get it from certifier_credentials_list, certifier_credentials_search or the create response. Example: 01hrsvjp560yksep2a3bek3z97.
delivery_methodstringrequired- How to deliver it. email is the only method. Example: email.one of
email
certifier_credential_template_createCreate a credential template (group) that ties a name to one or more certificate or badge designs.WriteCreate Credential Template
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.
Inputs
design_idsarrayrequired- Ordered list of at least one design template ID, from certifier_design_templates_list. Example: ["01fpwtztwf7sacca5r0c483mnm"]
namestringrequired- Template name, shown on credentials as group.name. Example: Financial Markets.
learning_event_urlstring- URL of the course or event, shown in the digital wallet. Example: https://www.coursera.org/learn/financial-markets-global.
certifier_credential_template_updateUpdate a credential template's name, designs or learning event URL.WriteUpdate Credential Template
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.
Inputs
template_idstringrequired- Credential template (group) ID. Get it from certifier_credential_templates_list. Example: 01g90279gp5sbmfek7wymcsvec.
design_idsarray- New ordered list of design template IDs; replaces the current list. Example: ["01fpwtztwf7sacca5r0c483mnm"]
learning_event_urlstring- New course or event URL. Example: https://example.com/course.
namestring- New template name. Example: Financial Markets 2026.
certifier_credential_updateUpdate a credential's recipient, dates or custom attributes.WriteUpdate Credential
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.
Inputs
credential_idstringrequired- Credential ID. Get it from certifier_credentials_list, certifier_credentials_search or the create response. Example: 01hrsvjp560yksep2a3bek3z97.
custom_attributesobject- 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_datestring- 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_datestring- Issuer-claimed issue date, YYYY-MM-DD. Leave out to use the UTC date at issuance. Example: 2026-01-15.
recipientobject- New recipient details: name and/or email. Example: {"name": "John Doe", "email": "john.doe@example.com"}
certifier_credential_deletePermanently delete a credential.DestructiveDelete Credential
Permanently delete a credential. This cannot be undone. Returns no content on success. Use this to remove a credential issued by mistake.
- Idempotent
Inputs
credential_idstringrequired- Credential ID. Get it from certifier_credentials_list, certifier_credentials_search or the create response. Example: 01hrsvjp560yksep2a3bek3z97.
certifier_credential_template_deletePermanently delete a credential template (group).DestructiveDelete Credential Template
Permanently delete a credential template (group). This cannot be undone. Returns no content on success. Use this to remove an unused template.
- Idempotent
Inputs
template_idstringrequired- Credential template (group) ID. Get it from certifier_credential_templates_list. Example: 01g90279gp5sbmfek7wymcsvec.
No tools match.