Actions39
- Contact Actions
- Transaction Actions
- Subscription Actions
- Affiliation Actions
- Checkout Actions
- Country Actions
- Coupon Actions
- Product Actions
- User Actions
- Webhook Actions
Overview
The "Guru Digital Manager" node allows users to interact with the Guru Digital Manager API to manage various resources such as contacts, transactions, subscriptions, and more. Specifically, for the Subscription - Get All operation, this node fetches a list of subscriptions from the API, optionally filtered by various criteria like contact details, creation dates, product ID, or subscription status.
This operation is useful when you want to retrieve multiple subscription records in bulk, for example:
- To synchronize subscription data with another system.
- To generate reports on active or cancelled subscriptions.
- To monitor subscription statuses over time.
Properties
| Name | Meaning |
|---|---|
| Additional Fields | Optional filters to narrow down the subscriptions returned. Includes: |
| - Contact ID: Filter by specific contact's ID | |
| - Contact Document: Filter by contact document (e.g., CPF/CNPJ) | |
| - Contact Email: Filter by contact email | |
| - Contact Name: Filter by contact name | |
| - Cursor: Pagination cursor for fetching next page | |
| - Created At Start: Filter subscriptions created on or after this date (YYYY-MM-DD) | |
| - Created At End: Filter subscriptions created on or before this date (YYYY-MM-DD) | |
| - Product ID: Filter by product ID | |
| - Subscription Status: Filter by one or more subscription statuses (Active, Inactive, Cancelled, Trial, Expired, Suspended) | |
| Return All | Boolean flag indicating whether to return all matching subscriptions or limit the number. |
| Limit | Maximum number of subscription records to return if Return All is false (1-100). |
Output
The output is a JSON array where each element represents a subscription object retrieved from the Guru Digital Manager API. Each subscription object contains fields as defined by the API, typically including identifiers, contact info, product details, status, creation date, and other subscription metadata.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for Guru Digital Manager API authentication.
- The base URL for the API defaults to
https://digitalmanager.guru/api/v2but can be overridden in credentials. - The node uses HTTP requests with Bearer token authorization to communicate with the API.
Troubleshooting
- Missing Credentials Error: If no API credentials are provided, the node will throw an error stating that credentials are required.
- API Request Failures: Network issues, invalid tokens, or incorrect base URLs can cause request failures. Verify your API token and base URL configuration.
- Pagination Issues: When using cursors for pagination, ensure the cursor value is correctly passed; otherwise, results may be incomplete.
- Filter Misconfiguration: Filters must be correctly formatted (e.g., dates in YYYY-MM-DD format). Incorrect filter values might result in empty responses.
- Limit Exceeded: The API limits the maximum number of results per request to 100. Use the "Return All" option to paginate through all results.
Links and References
- Guru Digital Manager API Documentation
- n8n Documentation on HTTP Request Node (for understanding underlying HTTP calls)