splitwise_create_group
Start a shared-expenses group for a trip, home, or couple; optionally invite members by existing user ID or by email in one call.
Instructions
Create a group, optionally with members (you are added automatically). 🔒 write.
Calls POST /create_group with name, group_type, simplify_by_default and the
members flattened to users__{i}__user_id or users__{i}__email /
users__{i}__first_name / users__{i}__last_name. Each member is EITHER an existing
user_id OR an email + first_name (+ last_name) to invite — checked locally
before any call. Refused with Error: … writes are disabled unless
SPLITWISE_ALLOW_WRITES=1. Undo: splitwise_delete_group with the returned id.
When to Use:
To start a new shared-expenses group (a trip, a flat, a couple).
When NOT to Use:
To add someone to an existing group (use
splitwise_add_user_to_group).To bring back a deleted group (use
splitwise_undelete_group).To find a friend's user id by name first (use
splitwise_resolve_friend).
Returns: A confirmation echoing what Splitwise returned: the new group's name, id, type and members, plus how many members were requested vs returned (a silently dropped invite shows up there).
Examples:
params = {"name": "Lima trip", "group_type": "trip", "members": [{"user_id": 5823}]}
params = {"name": "Flat", "group_type": "home", "simplify_by_default": true, "members": [{"email": "ana@example.com", "first_name": "Ana", "last_name": "Diaz"}]}
Error Handling:
A member with both or neither identity is rejected before the call. Splitwise's 400
field errors (e.g. a blank name) are surfaced as Error (400): ....
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |