Skip to main content
CertSeal logo
  • Category: signatures
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 21
  • Triggers: 0
  • Slug: CERT_SEAL
  • Version: 20261101_00

Tools

Slug: CERT_SEAL_CREATE_BATCHCreate a persistent certificate batch from an existing CertSeal design and optional email template. This consumes a batch slot and can fail when the plan batch limit is reached; designs and templates must already exist and are not created by this tool.

Input Parameters

string
required
Non-empty batch title.
string
required
ID of an existing design in this workspace; obtain it from CERT_SEAL_LIST_DESIGNS.
string
Optional course or achievement name printed in certificate context.
string
Optional batch description.
string
Optional issuer name printed in certificate context.
string
Existing workspace email template ID; required later if certificate emails will be sent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_CREATE_WEBHOOK_SUBSCRIPTIONCreate a persistent webhook subscription for selected certificate events. The response contains a wh_sec_ signing secret exactly once; capture it immediately and store it securely because later reads reveal only its tail. The workspace allows at most 20 subscriptions.

Input Parameters

string
required
Public HTTPS callback URL. Loopback, link-local, private-network, and other non-public literal IP addresses are not allowed.
array
required
Unique certificate event types to deliver to the callback URL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_DELETE_RECIPIENTPermanently delete an issued recipient from an active batch. This cannot be undone, does not refund certificate quota, and permanently burns the certificate ID. Use only when permanent removal is intended.

Input Parameters

string
required
Active parent batch ID.
string
required
Recipient ID to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_DELETE_WEBHOOK_SUBSCRIPTIONPermanently delete a webhook subscription and stop future deliveries. This cannot be undone; create a new subscription to resume events.

Input Parameters

string
required
Webhook subscription ID to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_GET_BATCHGet one active or archived certificate batch by ID.

Input Parameters

string
required
Batch ID from CERT_SEAL_LIST_BATCHES or CERT_SEAL_CREATE_BATCH.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_GET_CERTIFICATELook up an issued certificate using either its human-readable certificate ID or its public-viewer share token, and return its recipient, batch, design, and resolved variables. Provide exactly one lookup value.

Input Parameters

string
Public-viewer share token from an issued recipient record. Provide exactly one of share_token or certificate_id.
string
Human-readable issued certificate ID. Provide exactly one of certificate_id or share_token.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_GET_CURRENT_WORKSPACEVerify the connected CertSeal API key and return the workspace ID and username it belongs to. Use this to confirm account context before creating or changing resources.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_GET_RECIPIENTGet one issued certificate recipient record by batch ID and recipient ID.

Input Parameters

string
required
Parent batch ID.
string
required
Recipient ID returned by issuance or recipient listing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_GET_WEBHOOK_SUBSCRIPTIONGet one webhook subscription by ID. This does not reveal the signing secret; it returns only the stored secret tail.

Input Parameters

string
required
Webhook subscription ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_ISSUE_AND_SEND_CERTIFICATESAtomically issue certificates for 1-100 recipients and queue email delivery for every created certificate. This irreversible external side effect requires every recipient to have an email address and the active batch to have an email template and configured mail delivery. Each recipient permanently consumes one certificate quota unit.

Input Parameters

string
required
Active batch ID that will own all issued certificates and has an email template.
array
required
One to 100 recipients to issue certificates for atomically. Every recipient must include an email address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_ISSUE_CERTIFICATESAtomically issue certificates without sending email for 1-100 recipients in one active batch. Each recipient permanently consumes one certificate quota unit even if later deleted; any invalid row, duplicate certificate ID, or quota failure creates none.

Input Parameters

string
required
Active batch ID that will own all issued certificates.
array
required
One to 100 recipients to issue certificates for atomically.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_LIST_BATCHESReturn one newest-first page of certificate batches in the connected workspace, filtered by archive state. The default is active batches; archived batches or all batches can be requested.

Input Parameters

integer
Maximum batches to return in this page (1-100).
string
Opaque next_cursor from a previous call; omit for the first page.
string ("active" | "archived" | "all")
Archive-state filter: active, archived, or all.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_LIST_DESIGNSReturn one newest-first page of reusable certificate designs. Designs are read-only through the API and must be authored in the CertSeal web app.

Input Parameters

integer
Maximum designs to return in this page (1-100).
string
Opaque next_cursor from a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_LIST_RECIPIENTSReturn one page of issued certificate recipients in a batch, optionally filtered by email delivery status.

Input Parameters

integer
Maximum recipients to return in this page (1-100).
string
Opaque next_cursor from a previous call; omit for the first page.
string
required
Parent batch ID.
string ("pending" | "queued" | "sending" | "sent" | "failed")
Optional email delivery-state filter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_LIST_WEBHOOK_SUBSCRIPTIONSReturn one newest-first page of webhook subscriptions. Stored signing secrets are never returned; secret_tail is only a non-sensitive identifier.

Input Parameters

integer
Maximum subscriptions to return in this page (1-100).
string
Opaque next_cursor from a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_ROTATE_WEBHOOK_SIGNING_SECRETImmediately invalidate a webhook subscription’s current signing secret and replace it. The new wh_sec_ secret is returned exactly once; capture and deploy it immediately or webhook verification will fail.

Input Parameters

string
required
Webhook subscription whose signing secret will be replaced immediately.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_SEND_CERTIFICATE_EMAILSSequentially queue irreversible certificate emails for 1–25 existing recipients in one active batch. Processing stops on failure or an unknown outcome; some provider errors fail the entire call, potentially after earlier emails were queued.

Input Parameters

string
required
Active parent batch ID configured with an email template.
array
required
One to 25 unique recipient IDs whose certificate emails will be queued in order. Every recipient must have an email address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_SEND_RECIPIENT_CERTIFICATE_EMAILQueue asynchronous certificate email delivery to one recipient. This causes an external email side effect and requires a recipient email, a batch email template, and configured mail delivery; already queued or in-flight recipients and archived batches are rejected.

Input Parameters

string
required
Active parent batch ID configured with an email template.
string
required
Recipient ID whose certificate email will be queued.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_SET_BATCH_ARCHIVEDIdempotently archive or unarchive a batch. Archiving freezes recipient create, update, delete, and send operations but preserves existing certificate URLs; unarchiving re-enables those writes. This persistent change is reversible.

Input Parameters

boolean
required
Set true to archive and freeze the batch, or false to reactivate it.
string
required
Batch ID whose archive state will change.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_TEST_WEBHOOK_SUBSCRIPTIONEnqueue one synthetic signed event through CertSeal’s normal webhook dispatcher. This causes a real external delivery to the subscription URL; it does not only validate the subscription locally.

Input Parameters

string ("certificate.issued" | "certificate.sent" | "certificate.failed" | "certificate.viewed")
Synthetic event type. Omit it to use the subscription’s first configured event.
string
required
Webhook subscription ID that will receive the synthetic event.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CERT_SEAL_UPDATE_RECIPIENTPartially update an issued certificate recipient. Only supplied fields change, while an explicit null clears an optional field; changing certificate_id must remain globally unique. Archived batches reject this mutation.

Input Parameters

object
Replacement custom string-variable object; omit to leave unchanged.
string
New recipient name; null clears it.
string
New recipient email; null clears it.
string
required
Parent batch ID.
string
New ISO issue date; null clears it.
string
New ISO expiry date; null clears it.
string
required
Recipient ID to update.
string
New globally unique certificate ID; null clears the override if supported by CertSeal.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not