To interact with Persefoni, add a step in a chain that uses a Persefoni connection command.
Requirements
To enable these commands, an IT admin must first configure the Persefoni connector.
Fetch Transactions
Note: The "Fetch Transactions" command was removed from the Persefoni API in late June of 2025.
Persefoni recommends that you use the Get Activities command instead, as it provides many of the same functions as "Fetch Transactions", has improved stability, and includes additional features such as date filtering and an improved response time.
Replacing "Fetch Transactions"
If you are managing Persefoni data via the Workiva Persefoni Connector, the "Fetch Transactions" node will likely appear as "Disabled" or "Legacy."
To restore functionality:
- Replace the Node: You must manually delete the "Fetch Transactions" command node from your workflow.
- Use "Get Activities": Insert the "Get Activities" command to pull your current carbon accounting data.
- Update the Mappings: The output schema for "Get Activities" is more specific than "Fetch Transactions" (see below); you may need to re-map your CSV or JSON variables to ensure they align with the new activity-based fields.
Get activities
To fetch all applicable activities for an account, add a Get activities command.
Properties
| Property | Detail |
|---|---|
| Named query |
Select from the dropdown menu:
|
| Organization ID |
Enter an organization ID to fetch the footprint activities from the specified parent organization in Persefoni. To include dependent organizations in your output, enable the Include children organizations option below. If no organization ID is provided, this will default to the associated user's organization. |
| Include children organizations | Enable this option to include children organizations in the output. |
| Reporting year |
Enter a year in YYYY format (e.g., 2022) to see only activities that occurred during that year. Note: This overwrites all subsequent date filters. |
| Modified date on or after | Include only records that were last modified on or after the date provided. Based on the date in the UTC time zone. Example: 2023-12-26. |
| Modified date on or before | Include only records that were last modified on or before the date provided. Based on the date in the UTC time zone. Example: 2023-12-26. |
| Activity start date on or after | Include only records with an activity start date on or after the date provided. Example: 2023-12-26. |
| Activity start date on or before | Include only records with an activity start date on or before the date provided. Example: 2023-12-26. |
| Activity end date on or after | Include only records with an activity end date on or after the date provided. Example: 2023-12-26. |
| Activity end date on or before | Include only records with an activity end date on or before the date provided. Example: 2023-12-26. |
Outputs
| Output | Output Type |
|---|---|
| Fetched activities | CSV file |
| File Size (Bytes) | Integer |
| Row count | Integer |
Exit codes
| Code | Type | Detail |
|---|---|---|
| 0 | Successful | Successful |
| 1 | Error | Error |