Zola API and MCP server

• POST

  list_guests

  Guests with their list (Definitely Invited or Maybe), events invited to and RSVP state.

  read

  Returns the guests on your guest list, each with the list they are on, the events they are invited to and their reply per event. Contact details are left out unless include_contact is true. Use guest_id from each item in the other tools.

  POST /api/v1/zola/list_guests

  Input

  Input: list_guests

  Parameter	Type	Description
  list	enum	definitely_invited, maybe or all. Default: all.
  include_contact	boolean	Add mailing address, email and phone. Default: false.
  search	string	Match on guest name.

  Example response

  {
    "guests": [
      {
        "guest_id": "gst_a41c07",
        "name": "Maria Example",
        "list": "definitely_invited",
        "events": [
          {
            "event_id": "evt_ceremony",
            "rsvp": "attending"
          },
          {
            "event_id": "evt_reception",
            "rsvp": "no_response"
          }
        ]
      },
      {
        "guest_id": "gst_a41c08",
        "name": "Tom Example",
        "list": "definitely_invited",
        "events": [
          {
            "event_id": "evt_ceremony",
            "rsvp": "declined"
          }
        ]
      }
    ]
  }

• POST

  list_events

  Your wedding events with type, name, date and start time.

  read

  Returns the events from "Your Events" in Zola: ceremony, reception, rehearsal dinner and any others you added. Use event_id from each item in the RSVP and invite tools. Guests can only RSVP to events they are invited to.

  POST /api/v1/zola/list_events

  Input

  No parameters.

  Example response

  {
    "events": [
      {
        "event_id": "evt_ceremony",
        "type": "Ceremony",
        "name": "Wedding Ceremony",
        "date": "2027-06-12",
        "start_time": "15:00"
      },
      {
        "event_id": "evt_reception",
        "type": "Reception",
        "name": "Dinner and Dancing",
        "date": "2027-06-12",
        "start_time": "18:00"
      }
    ]
  }

• POST

  track_rsvps

  RSVPs for one event: who is attending, declined or has not replied, with meal choices.

  read

  Returns the replies for one event with each guest's status, meal choice and answers to the questions you added to the event. Online RSVPs from your wedding website and replies you recorded by hand are both included. Meal totals are counted from the attending guests.

  POST /api/v1/zola/track_rsvps

  Input

  Input: track_rsvps

  Parameter	Type	Description
  event_id required	string	Event ID from list_events.
  status	enum	attending, declined, no_response or all. Default: all.

  Example response

  {
    "event_id": "evt_reception",
    "counts": {
      "attending": 2,
      "declined": 1,
      "no_response": 1
    },
    "meals": {
      "Chicken": 1,
      "Fish": 1
    },
    "rsvps": [
      {
        "guest_id": "gst_a41c07",
        "name": "Maria Example",
        "status": "attending",
        "meal_choice": "Chicken"
      },
      {
        "guest_id": "gst_a41c08",
        "name": "Tom Example",
        "status": "attending",
        "meal_choice": "Fish"
      },
      {
        "guest_id": "gst_a41c09",
        "name": "Ana Example",
        "status": "declined",
        "meal_choice": null
      },
      {
        "guest_id": "gst_a41c10",
        "name": "Sam Example",
        "status": "no_response",
        "meal_choice": null
      }
    ]
  }

• POST

  list_gifts

  Gift tracker: each gift with giver, message, value, giver address, order status and thank-you note status.

  read

  Returns the gifts in your gift tracker with the fields Zola's CSV download has: order number, name, quantity, value, gift message, giver's address, order status and thank-you note status. Use gift_id from each item in mark_thank_you_sent.

  POST /api/v1/zola/list_gifts

  Input

  Input: list_gifts

  Parameter	Type	Description
  thank_you	enum	sent, not_sent or all. Default: all.

  Example response

  {
    "gifts": [
      {
        "gift_id": "gft_8f21c4",
        "order_number": "ZO-100412",
        "name": "Dutch Oven",
        "quantity": 1,
        "value": 389,
        "giver": "Alex Example",
        "message": "Congratulations!",
        "address": "12 Example Street, Springfield, IL 62701",
        "order_status": "delivered",
        "thank_you": "not_sent"
      },
      {
        "gift_id": "gft_8f21d9",
        "order_number": "ZO-100417",
        "name": "Honeymoon Fund",
        "quantity": 1,
        "value": 150,
        "giver": "Sam Example",
        "message": "Have a great trip.",
        "address": "4 Sample Road, Portland, OR 97201",
        "order_status": "completed",
        "thank_you": "not_sent"
      }
    ]
  }

• POST

  add_guest

  Add a guest, optionally with a plus-one, to your guest list. Nothing is sent to the guest.

  write

  Adds a guest to "Definitely Invited" or "Maybe" and returns the new guest_id. A plus-one is added as a second guest in the same party. Nothing is sent to anyone, so add_guest runs without asking first. Events are set with invite_guest_to_event.

  POST /api/v1/zola/add_guest

  Input

  Input: add_guest

  Parameter	Type	Description
  first_name required	string	Guest first name.
  last_name required	string	Guest last name.
  email	string	Guest email.
  phone	string	Guest phone number.
  plus_one	object	first_name and last_name of the plus-one, if known.
  list	enum	definitely_invited or maybe. Default: definitely_invited.

  Example response

  {
    "guest_id": "gst_b7720e",
    "name": "Maria Example",
    "list": "definitely_invited",
    "plus_one": {
      "guest_id": "gst_b7720f",
      "name": "Tom Example"
    },
    "status": "added"
  }

• POST

  update_guest_address

  Set the mailing address used for Save the Dates and invitation envelopes.

  write

  Replaces the mailing address of one guest, the address shown on the "Address Envelopes" page. Nothing is sent to the guest, so it runs without asking first, and calling it again with the old address undoes it.

  POST /api/v1/zola/update_guest_address

  Input

  Input: update_guest_address

  Parameter	Type	Description
  guest_id required	string	Guest ID from list_guests.
  address required	object	address_1, address_2, city, state_province, postal_code, country_code.

  Example response

  {
    "guest_id": "gst_a41c07",
    "address": {
      "address_1": "12 Example Street",
      "address_2": null,
      "city": "Springfield",
      "state_province": "IL",
      "postal_code": "62701",
      "country_code": "US"
    },
    "status": "updated"
  }

• POST

  invite_guest_to_event

  Mark a guest as invited to an event, so they can RSVP to it on your wedding website.

  write

  Adds an event to the events a guest is invited to, the choice you make on the "Invite Guests to Events" tab. Guests can only RSVP to events they are invited to. It sends no message, so it runs without asking first.

  POST /api/v1/zola/invite_guest_to_event

  Input

  Input: invite_guest_to_event

  Parameter	Type	Description
  event_id required	string	Event ID from list_events.
  guest_id required	string	Guest ID from list_guests.

  Example response

  {
    "guest_id": "gst_a41c07",
    "event_id": "evt_reception",
    "invited": true
  }

• POST

  record_rsvp

  Record a reply you got by phone or mail: attending or declined, with meal choice.

  write

  Records the reply of one guest to one event, the same as entering it under "Track RSVPs". The guest must be invited to the event, and meal_choice must be one of the options set on it. It changes only your own records and one more call corrects it, so it runs without asking first.

  POST /api/v1/zola/record_rsvp

  Input

  Input: record_rsvp

  Parameter	Type	Description
  event_id required	string	Event ID from list_events.
  guest_id required	string	Guest ID from list_guests.
  status required	enum	attending or declined.
  meal_choice	string	One of the meal options set on the event.

  Example response

  {
    "guest_id": "gst_a41c07",
    "event_id": "evt_reception",
    "status": "attending",
    "meal_choice": "Vegetarian",
    "recorded": true
  }

• POST

  mark_mail_sent

  Track that a guest has received a Save the Date or an invitation.

  write

  Updates the mail tracking on the "Address Envelopes" page for one guest. It does not mail anything and reaches no one, so it runs without asking first.

  POST /api/v1/zola/mark_mail_sent

  Input

  Input: mark_mail_sent

  Parameter	Type	Description
  guest_id required	string	Guest ID from list_guests.
  type required	enum	save_the_date or invitation.

  Example response

  {
    "guest_id": "gst_a41c07",
    "type": "save_the_date",
    "mailed": true
  }

• POST

  mark_thank_you_sent

  Mark the thank-you note for one or more gifts in the gift tracker as sent.

  write

  Sets the thank-you note status of the gifts you pass, as the gift tracker does for one gift at a time. Set sent to false to undo. It changes only your tracker and nothing goes to the giver, so it runs without asking first.

  POST /api/v1/zola/mark_thank_you_sent

  Input

  Input: mark_thank_you_sent

  Parameter	Type	Description
  gift_ids required	string[]	Gift IDs from list_gifts.
  sent	boolean	false to undo. Default: true.

  Example response

  {
    "updated": [
      {
        "gift_id": "gft_8f21c4",
        "gift": "Dutch Oven",
        "giver": "Alex Example",
        "thank_you": "sent"
      },
      {
        "gift_id": "gft_8f21d9",
        "gift": "Honeymoon Fund",
        "giver": "Sam Example",
        "thank_you": "sent"
      }
    ]
  }

Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.