Splitwise icon

Splitwise

Consume the Splitwise API

Actions9

Overview

This node integrates with the Splitwise API to manage groups and expenses. Specifically, for the Group - Restore operation, it allows users to restore a previously deleted group by providing its Group ID. This is useful in scenarios where a group was accidentally deleted or needs to be reactivated without recreating it from scratch.

Practical example:

  • A user accidentally deletes a group used for tracking shared expenses among roommates. Using this node's restore operation, they can quickly recover that group and all its associated data.

Properties

Name Meaning
Authentication Method of authenticating with Splitwise API. Options: "API Key" or "OAuth2".
Group ID The unique numeric identifier of the group to restore. Must be a non-negative integer.

Output

The output JSON contains a success confirmation object:

{
  "success": true
}
  • If the restore operation succeeds, the output indicates success.
  • If it fails, an error is thrown (or returned if "continue on fail" is enabled).
  • No binary data is output by this operation.

Dependencies

  • Requires access to the Splitwise API at https://secure.splitwise.com/api/v3.0.
  • Requires valid authentication credentials, either an API key or OAuth2 token configured in n8n.
  • Uses the internal helper function to make authenticated HTTP requests to Splitwise endpoints.

Troubleshooting

  • Common issues:

    • Invalid or missing Group ID: Ensure the Group ID provided exists and is correct.
    • Authentication failure: Verify that the API key or OAuth2 credentials are correctly set up and have necessary permissions.
    • Network or API errors: Check internet connectivity and Splitwise API status.
  • Error messages:

    • "Could not restore group": Indicates the API call to restore the group failed. Possible causes include invalid Group ID or insufficient permissions.
      • Resolution: Confirm the Group ID is correct and the credentials have rights to restore groups.
    • Other errors returned by the API will be surfaced as node execution errors with their message.

Links and References

Discussion