dots.eco icon

dots.eco

Work with dots.eco API. Rewarding you for casually saving the planet.

Eco Club → Create Offering

AI-generated

Overview

This node operation creates an offering in the Eco Club system via the dots.eco API. It allows users to specify various parameters such as the quantity of impact to grant, allocation limits, activation date and time, email notifications, custom codes, recipient details, claim limits, language, and currency. This operation is useful for managing and automating the creation of impact reward offerings in an environmental or sustainability-focused application.

Use Case Examples

  1. Creating an Eco Club offering that grants a specific quantity of impact points to users, with optional allocation restrictions and activation scheduling.
  2. Setting up a custom claim code and email notification for an Eco Club offering to engage recipients effectively.

Properties

Name Meaning
App Token Application token used to manage Eco Club offerings.
Quantity Impact quantity to grant when the Eco Club offering is claimed.
Allocation Limit Input Mode Choose whether to enter allowed allocation IDs manually or select them from Dots.eco.
Limit Allocations Optional comma-separated allocation IDs allowed for this offering. Leave empty to allow all allocations.
Lookup Company ID Company ID used only to fetch available allocations.
Allocations Select the allocations allowed for this offering. Selected IDs are serialized back into the existing limit_allocations CSV field.
Name on Certificate Optional name rendered on certificates created by this offering.
Activation Date Optional date when the offering becomes active.
Activation Hour Optional time when the offering becomes active.
Send Email on Activation Date Optionally send the offering email automatically on the activation date.
Code Optional custom claim or redemption code for the offering.
Email Optional email used for the offering recipient or claim flow.
Title Optional public title for the offering.
Remote User ID Optional external user identifier associated with the claim.
Max Claims Total Optional total number of times the offering can be claimed.
Max Claims Per Email Optional maximum number of claims allowed per email address.
Language Optional language for localized offering responses and claim URLs.
Currency Optional currency for the offering.

Output

JSON

  • json - The JSON response from the dots.eco API representing the created offering details or error information.

Dependencies

  • dotsEcoApi credential for authentication with the dots.eco API

Troubleshooting

  • Common issues include invalid or missing App Token, incorrect allocation IDs, or invalid date/time formats for activation. The node may throw errors if required parameters are missing or if the API request fails due to authentication or validation errors.
  • Error messages typically indicate the nature of the failure, such as authentication errors (invalid token), validation errors (invalid parameters), or network issues. Users should verify their credentials, input parameters, and network connectivity to resolve these errors.

Discussion