Accredible certificates

Learn how to use Accredible certificates with Composio

Overview

SLUG: ACCREDIBLE_CERTIFICATES

Description

Accredible Certificates is a platform that enables organizations to create, manage, and distribute digital certificates, open badges, and blockchain credentials.

Authentication Details

generic_api_key
stringRequired

Connecting to Accredible certificates

Create an auth config

Use the dashboard to create an auth config for the Accredible certificates toolkit. This allows you to connect multiple Accredible certificates accounts to Composio for agents to use.

1

Select App

Navigate to [Accredible certificates](https://platform.composio.dev/marketplace/Accredible certificates).

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Accredible certificates Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4accredible_certificates_auth_config_id = "ac_YOUR_ACCREDIBLE_CERTIFICATES_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10 # Replace this with a method to retrieve an API key from the user.
11 # Or supply your own.
12 user_api_key = input("[!] Enter API key")
13
14 connection_request = composio.connected_accounts.initiate(
15 user_id=user_id,
16 auth_config_id=auth_config_id,
17 config={"auth_scheme": "API_KEY", "val": user_api_key}
18 )
19
20 # API Key authentication is immediate - no redirect needed
21 print(f"Successfully connected Accredible certificates for user {user_id}")
22 print(f"Connection status: {connection_request.status}")
23
24 return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, accredible_certificates_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [Accredible certificates toolkit’s playground](https://app.composio.dev/app/Accredible certificates)

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["ACCREDIBLE_CERTIFICATES"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Bulk Create Credentials (V2)

Description

Tool to bulk create credentials. use when batching up to 30 credentials in one call; supports multi-status (207) responses.

Action Parameters

credentials
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Clone Group

Description

Tool to clone an existing group. use after confirming the source group exists and you need a copy with optional overrides.

Action Parameters

allow_duplicate_credentials
boolean
attach_pdf
boolean
auto_expiry
integer
badge_design_id
integer
blockchain
boolean
certificate_design_id
integer
course_description
string
course_link
course_link_show
boolean
course_name
string
generate_private_credential
boolean
group_id
integerRequired
language
string
learning_outcomes
array
meta_data
object
name
string
organization_link_show
boolean
primary_design_id
integer
signup_url
signup_url_show
boolean
skill_category_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Collection

Description

Tool to create a new collection. use when you need a curated set of groups.

Action Parameters

description
string
name
stringRequired
public
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Evidence Item

Description

Tool to create a new evidence item for a credential. use after confirming credential id.

Action Parameters

category
stringRequired
credential_id
stringRequired
custom_insight
string
description
stringRequired
file
position
integer
preview
string_object
string
url

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Group

Description

Tool to create a new group. use after gathering all group details.

Action Parameters

allow_duplicate_credentials
boolean
attach_pdf
boolean
auto_expiry
integer
badge_design_id
integer
blockchain
boolean
certificate_design_id
integer
collections
array
course_description
stringRequired
course_link
course_link_show
boolean
course_name
stringRequired
department_id
integer
generate_private_credential
boolean
language
stringDefaults to en
learning_outcomes
array
meta_data
object
name
stringRequired
organization_link_show
boolean
primary_design_id
integer
signup_url
signup_url_show
boolean
skill_category_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Credential

Description

Tool to delete a credential. use after confirming you want to permanently remove an existing credential. executes delete on /credentials/{credential id} endpoint and returns status code.

Action Parameters

credential_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Group

Description

Tool to delete a group. use after confirming no credentials remain and when you need to permanently remove the group.

Action Parameters

group_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Reference

Description

Tool to delete a specific reference by id. use after confirming both credential id and reference id. example: "delete reference 1234 from credential 'abc123'."

Action Parameters

credential_id
stringRequired
reference_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Generate PDFs for Credentials

Description

Tool to generate pdfs for multiple credentials. use when you need to batch-download a zip archive of certificate pdfs for a list of published credential ids. example: "generate pdfs for credentials [10000005, 10272642]".

Action Parameters

credential_ids
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Templates

Description

Tool to retrieve a list of all templates. use after authentication to fetch paginated certificate templates.

Action Parameters

page
integerDefaults to 1
per_page
integerDefaults to 50

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Search Collections

Description

Tool to search for collections. use when you need to filter collections by ids, name, or public flag and paginate through results. e.g., "search for public collections named 'abc' on page 2."

Action Parameters

meta
object
query
objectRequired
sort
object

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Group

Description

Tool to update an existing group. use when you need to modify group details after fetching its current data.

Action Parameters

allow_duplicate_credentials
boolean
attach_pdf
boolean
auto_expiry
integer
badge_design_id
integer
blockchain
boolean
certificate_design_id
integer
collections
array
course_description
string
course_link
course_link_show
boolean
course_name
string
department_id
integer
generate_private_credential
boolean
group_id
integerRequired
language
string
learning_outcomes
array
meta_data
object
name
string
organization_link_show
boolean
primary_design_id
integer
signup_url
signup_url_show
boolean
skill_category_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Reference

Description

Tool to update a reference by id. use when you need to modify a reference's details for a credential. use after retrieving the reference id to change comments or relationship.

Action Parameters

credential_id
stringRequired
reference
objectRequired
reference_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: View All Skill Categories

Description

Tool to retrieve all skill categories. use when you need to list all available skill categories (e.g., to link them to groups).

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired