Actions19
- Allocation Actions
- Application Actions
- Certificate Actions
- Eco Club Actions
- Flow Card Actions
- Impact Actions
- Notification Actions
- Utility Actions
Certificate → Create
AI-generatedOverview
This node operation creates a certificate in the dots.eco system. It is useful for applications that want to reward users with certificates representing environmental impact, such as carbon offsetting or sustainability achievements. For example, an app can create a certificate for a user by specifying the impact quantity, allocation, and user details, optionally sending the certificate by email or customizing its design.
Use Case Examples
- Creating a certificate for a user with a specified impact quantity and allocation ID.
- Automatically generating certificates for users after completing eco-friendly actions in an app.
Properties
| Name | Meaning |
|---|---|
| App Token | Application token used to authenticate and create the certificate. |
| External Unique ID | Unique external identifier to deduplicate or retrieve certificates, must be unique per app when creating. |
| Impact Quantity | Amount of environmental impact to attach to the certificate. |
| Allocation Input Mode | Choose whether to enter the allocation ID manually or select it from dots.eco. |
| Allocation ID | Allocation ID to attach to the certificate, used in manual mode. |
| Lookup Company ID | Company ID used to fetch available allocations, used in lookup mode. |
| Allocation | Select an allocation from dots.eco to populate Allocation ID, used in lookup mode. |
| Remote User ID | External user identifier associated with the certificate. |
| Name on Certificate | Optional name rendered on the certificate. |
| Remote User Email | Optional email associated with the certificate recipient. |
| Certificate Design | Optional certificate theme or design identifier. |
| Send Certificate by Email | Optionally send the certificate to the recipient by email. |
| Certificate Info | Optional extra information or metadata stored with the certificate. |
| Create Async Image | Optionally defer certificate image generation. |
| Language | Optional language for localized certificate text and claim URLs. |
| Currency | Optional currency for certificate pricing and totals. |
Output
JSON
id- Unique identifier of the created certificate.externalUniqueId- External unique identifier of the certificate.impactQty- Amount of impact attached to the certificate.allocationId- Allocation ID associated with the certificate.remoteUserId- External user identifier associated with the certificate.nameOnCertificate- Name rendered on the certificate.remoteUserEmail- Email associated with the certificate recipient.certificateDesign- Theme or design identifier of the certificate.sendCertificateByEmail- Indicates if the certificate was sent by email.certificateInfo- Additional information stored with the certificate.createAsyncImage- Indicates if image generation was deferred.langcode- Language code used for localized text.currency- Currency code used for pricing and totals.
Dependencies
- dots.eco API authentication token
Troubleshooting
- Error 422 indicates the externalUniqueId is not unique per app; use a unique value to avoid this error.
- Ensure required fields like appToken, impactQty, allocationId (or allocation lookup) and remoteUserId are provided to prevent validation errors.
- If using lookup mode for allocation, ensure the company ID and allocation selection are valid and accessible.
- Check API credentials and permissions if authentication errors occur.
Links
- dots.eco API Documentation - Official API documentation for dots.eco, including certificate creation endpoints.