add_guest
Add a guest household to a Zola guest list with an optional plus-one, mailing address, and event invitations, creating a fully set-up household in one call.
Instructions
Add a new guest group (household) to the guest list, optionally with a partner/plus-one, mailing address and event invitations, so one call creates a fully set-up household. Affiliation is relative to the Zola account owner: PRIMARY_* is the account owner's side, PARTNER_* is the other partner's side (the web UI labels PARTNER_* with the partner's name, e.g. "'s Family Friend"). Check list_guests for duplicates first. Guests are invited only to the events in event_ids — none when omitted. Adds to the list only: no invitation, save-the-date or email is sent.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"first_name": "<first_name>",
"last_name": "<last_name>"
},
"name": "add_guest"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | ||
| tier | No | Guest-list tier (default: A) | |
| No | Primary guest email address | ||
| phone | No | Primary guest mobile phone | |
| address1 | No | Street address (applied to every guest in the household) | |
| address2 | No | ||
| event_ids | No | Event ids from list_events to invite every guest in the household to. Omit to invite to none. | |
| last_name | Yes | Primary guest last (family) name | |
| first_name | Yes | Primary guest first name | |
| affiliation | No | Relationship to the couple (default PRIMARY_FRIEND). PRIMARY_* = the account owner's side; PARTNER_* = the other partner's side. Known values: PRIMARY_FRIEND, PRIMARY_FAMILY, PRIMARY_FAMILY_FRIEND, PARTNER_FRIEND, PARTNER_FAMILY, PARTNER_FAMILY_FRIEND, BOTH, UNKNOWN. Case-insensitive. | |
| postal_code | No | ||
| country_code | No | Default: US (only sent with an address) | |
| state_province | No | State / province code, e.g. FL | |
| plus_one_last_name | No | Partner / plus-one last name (default: the primary guest's last name) | |
| plus_one_first_name | No | Partner / plus-one first name |