splitwise_create_friend
Add one person as a Splitwise friend by email to share non-group expenses. Requires writes enabled; provide a first name when the email has no account.
Instructions
Add one person as a Splitwise friend by e-mail. 🔒 Needs SPLITWISE_ALLOW_WRITES=1.
Calls POST /create_friend with user_email (+ user_first_name /
user_last_name when given). If an account already exists for that e-mail the
names are ignored; if not, Splitwise creates an invited user and user_first_name
is required. If you don't know whether they have an account, pass user_first_name;
it is ignored for existing users. Adding someone without an account probably sends
them an invitation e-mail (unverified; the live smoke t10 confirms). 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 one person so you can share non-group expenses with them.
When NOT to Use:
To add several people at once (use
splitwise_create_friends).To add someone to a group (use
splitwise_add_user_to_group).To check whether someone is already a friend (use
splitwise_get_friendsorsplitwise_resolve_friend).
Returns:
A confirmation echoing the friend Splitwise returned: First Last (id N), e-mail and
registration status.
Examples:
Existing user: params = {"user_email": "grace@example.com"}
New user: params = {"user_email": "alan@example.com", "user_first_name": "Alan", "user_last_name": "Turing"}
Error Handling:
Error: … writes are disabled → set SPLITWISE_ALLOW_WRITES=1. A 400 usually means an
invalid e-mail or a missing first name for a new user. On a 5xx/timeout the outcome
is UNKNOWN — check splitwise_get_friends before retrying.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |