Overview
This node integrates with the Splitwise API to manage groups and expenses. Specifically, for the Group - Get operation, it retrieves detailed information about a specific group by its name or ID. This is useful when you want to fetch group details such as members, balances, or other metadata stored in Splitwise.
Common scenarios include:
- Fetching group details before creating or updating expenses linked to that group.
- Displaying group information in dashboards or reports.
- Synchronizing group data from Splitwise into other systems.
Example: You have a group named "Trip to Spain" in Splitwise and want to retrieve all its details to display in your app or use them in further workflow steps.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with Splitwise API. Options: API Key or OAuth2. |
| Group Name or ID | The identifier of the group to retrieve. Can be selected from a list of existing groups or specified via an expression. This is required for the Get operation on groups. |
Output
The output JSON contains the full details of the requested group under the json field. This includes all properties returned by the Splitwise API's /get_group/{id} endpoint, typically:
- Group ID
- Group name
- Members and their details
- Balances and expenses summary
- Other metadata related to the group
No binary data is output by this operation.
Dependencies
- Requires access to the Splitwise API.
- Requires either an API key credential or OAuth2 authentication configured in n8n.
- The base URL used is
https://secure.splitwise.com/api/v3.0. - The node uses internal helper functions to make authenticated HTTP requests to Splitwise.
Troubleshooting
- Error: Could not get group — This may occur if the provided group ID or name does not exist or the user lacks permission. Verify the group identifier and authentication credentials.
- Authentication errors — Ensure the API key or OAuth2 token is valid and has the necessary scopes.
- Rate limiting or network issues — The Splitwise API may throttle requests; handle retries or check connectivity.
- If the node throws errors related to missing parameters, ensure the "Group Name or ID" property is set correctly.
Links and References
- Splitwise API Documentation
- n8n Expressions Documentation (for using expressions in the Group ID field)