List
AI-generatedOverview
This node integrates with the Braze platform to manage and trigger marketing campaigns. It allows users to list campaigns, retrieve detailed information, trigger campaigns immediately or schedule them for future delivery, cancel scheduled campaigns, and fetch campaign performance analytics.
A common use case is automating campaign management within a marketing workflow: for example, listing all active campaigns to monitor their status, triggering a campaign based on user behavior, or scheduling a campaign to be sent at an optimal time.
Practical examples:
- Listing all campaigns edited after a certain date to review recent marketing efforts.
- Triggering a personalized campaign to a specific set of users immediately after they perform an action.
- Scheduling a campaign to be sent tomorrow morning in the recipients' local time zones.
- Fetching analytics data to evaluate campaign effectiveness over the past two weeks.
Properties
| Name | Meaning |
|---|---|
| Page | Page number (0-indexed) of campaigns to return when listing campaigns. |
| Include Archived | Whether to include archived campaigns in the list results (true/false). |
| Sort Direction | Sort order for campaigns when listing: "Ascending (Oldest First)" or "Descending (Newest First)". |
| Last Edit Time Filter | Only return campaigns edited after this ISO 8601 timestamp. |
Output
The node outputs JSON objects representing the response from the Braze API for each operation:
- For List operation: An array of campaign objects matching the filter criteria.
- For Details operation: Detailed information about a specific campaign.
- For Trigger and Schedule Trigger operations: Confirmation and details of the triggered or scheduled campaign.
- For Cancel Scheduled Campaign operation: Confirmation of cancellation.
- For Analytics operation: Time series data representing campaign performance metrics.
If an error occurs during execution, the output JSON will contain an error field describing the issue along with HTTP status code and Braze-specific error codes if available.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the Braze API.
- Needs network access to Braze's REST API endpoints.
- The node uses standard HTTP methods (GET, POST) to interact with Braze services.
Troubleshooting
Common issues:
- Invalid or missing API key credential will cause authentication failures.
- Providing invalid campaign IDs or schedule IDs will result in errors from Braze.
- Incorrectly formatted timestamps for filters may lead to no results or errors.
- Network connectivity problems can cause request failures.
Error messages:
- Errors returned by Braze are captured and included in the output JSON under the
errorfield. - HTTP status codes and Braze error codes are also provided to help diagnose issues.
- To resolve errors, verify credentials, input parameters, and ensure the Braze API service is reachable.
- Errors returned by Braze are captured and included in the output JSON under the