splitwise_create_friends
Add several people as Splitwise friends in a single batch before sharing group expenses. Supply emails and optional names to create accounts when needed.
Instructions
Add several people as Splitwise friends in one call. 🔒 Needs SPLITWISE_ALLOW_WRITES=1.
Calls POST /create_friends with the list flattened to
users__{i}__email / users__{i}__first_name / users__{i}__last_name (index from
0). Names matter only for people without a Splitwise account yet. Splitwise answers
HTTP 200 even when it rejects entries, so success is read from the body's errors.
Refused with Error: … writes are disabled unless SPLITWISE_ALLOW_WRITES=1. There is
no undo tool; remove a friend with splitwise_delete_friend.
When to Use:
To befriend a list of people (e.g. trip companions) before sharing expenses.
When NOT to Use:
For a single person (use
splitwise_create_friend).To put people in a group (use
splitwise_create_group/splitwise_add_user_to_group).
Returns:
A confirmation listing every user Splitwise returned (First Last (id N), e-mail,
registration status) and the body's errors (none on success). On a rejected batch
the Error: is followed by the users Splitwise still listed in users[] (probably
the ones it added) and a read-back hint.
Examples:
params = {"friends": [{"email": "grace@example.com"}, {"email": "alan@example.com", "first_name": "Alan", "last_name": "Turing"}]}
Error Handling:
Duplicate e-mails in the list are rejected locally before any call. If Splitwise
reports any error the call is returned as an Error: — the people its response still
listed are named under it (probably added), so read back with splitwise_get_friends
before retrying. On a 5xx/timeout the outcome is UNKNOWN.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |