# Create Perfect Venue leads from emails and phone calls

> Turn an inquiry sent to your own inbox, or taken by phone, into a Perfect Venue lead with date, guests and space, after a duplicate check.

Source: https://cotlet.dev/integrations/perfect-venue-api-mcp-server/create-leads-from-emails

The contact form feeds Perfect Venue on its own, but the planner who emails the manager directly, the caller on a Friday night and the DM on Instagram do not. Those inquiries wait in someone's personal mailbox until they find time to type them in.

Cotlet does it in your own Perfect Venue account with list\_events, list\_spaces, create\_lead and send\_email, called by your AI agent, an n8n workflow or a script.

[Request access](https://cotlet.dev/app/signup?app=perfect-venue) [All Perfect Venue tools](https://cotlet.dev/integrations/perfect-venue-api-mcp-server)

Hosted · nothing to install or maintain

Official options

## Can Perfect Venue do this on its own?

Perfect Venue offers two official routes (checked 12 Oct 2026). The Leads API creates a lead with status Lead, but only on the Enterprise plan and only from origins allow-listed under Settings > API > Allowed Origins, which is built for a website form. The help center also documents a Zapier template that creates events from forwarded emails: it needs a Zapier Professional plan or higher, uses 3 Zapier tasks per event, and creates wrong event times if the time zone in its AI Formatter step is not set. Neither help article describes a check for a guest who is already in Perfect Venue, and neither route takes a phone call.

By hand

## How you do it in Perfect Venue today

1. Copy the guest's name, email, phone, date, times and party size out of the email or your call notes.
2. In Perfect Venue, add the event by hand: date, start and end time, group size, event type, the space the guest asked for and the contact information.
3. Paste the guest's own words into the event so the next person sees what was asked, and note where the inquiry came from, since a hand-typed event carries no Source or Campaign.
4. Write the first reply yourself: Perfect Venue First Reply only answers contact-form inquiries, so a lead typed in by hand gets no automatic response.
5. The pain is the gap: until someone retypes it, the inquiry does not appear on Home, in the Inbox or in the Events report, and a second inquiry from the same guest is easy to enter twice.

With an agent

## How to create Perfect Venue leads from emails and phone calls

Prompt

```
Add this emailed inquiry as a Perfect Venue lead: Sam Rivera, sam.rivera@example.com, rehearsal dinner for 40 on Saturday 14 Nov, 18:00 to 22:00, wants the Private Room. Check first that Sam is not already in Perfect Venue.
```

1. 01  
### Pull out the fields, stop on gaps  
The agent reads the inquiry for first name, email, date, start and end time, guest count and event type. Without an email address there is no lead to create, so it stops and asks you for one. A date given as "next Saturday" is turned into a calendar date and repeated back in the report.
2. 02  
### Look for the guest first  
list\_events around the requested date, and in the open stages, is searched for the same contact email. If the guest already has an open event, the agent does not create a second one; it reports the existing event so you can add the new details there.
3. 03  
### Name the right room  
list\_spaces turns "the back room" or "Private Room" into a space ID. If the name matches nothing, the lead is created without a space and the guest's wording goes into the message, so nobody books the wrong room.
4. 04  
### Create the lead  
create\_lead runs without asking, because the lead itself sends nothing; an Automated Reminder Email you set for the Lead stage can still go out on its own. The original text of the inquiry and where it came from ("phone call, 9 Oct") go into the message field, which keeps the source visible on the event.
5. 05  
### Offer the first reply  
Since First Reply skips leads created this way, the agent offers a reply with send\_email in the new event thread. That email reaches the guest, so it waits for your OK.

### What you get back

Example data

```
Created lead ev_8841: Sam Rivera, rehearsal dinner, Sat 14 Nov 2026, 18:00 to 22:00, 40 guests, Private Room.
Message saved: "Emailed to events@ on 12 Oct. Wants a set menu, two vegetarians."
Not created: Dana Kim already has open event ev_8790 (Qualified, 21 Nov). New details reported to you.
Not created: voicemail from "Tom" left no email address. Please add one.
First reply to Sam drafted in the event thread, waiting for your OK.
```

### Other ways to ask

- Every morning, go through the emails labeled "Events" in my Gmail and add each new inquiry to Perfect Venue as a lead.
- I just took a call: Priya, priya@example.com, 25 people, corporate lunch on 3 Dec at noon, patio if the weather allows. Add her.
- Add these three inquiries from the wedding fair as leads at our Downtown venue, and do not send any email yet.

Before you automate it

## What Perfect Venue allows, and what to know first

- Perfect Venue keeps first name, email and "tell us about your event" as fixed required fields on every contact form, so those three are the minimum a hand-entered lead should match.
- Perfect Venue gives every contact-form inquiry the Lead status, and the Leads API places its leads in the inbox as a new event with status Lead as well.
- Source and Campaign tracking on Perfect Venue leads comes from tracking URLs on Premium and Enterprise plans; a lead typed in by hand has no tracking link, so the source belongs in the message.
- The Perfect Venue Zapier template for emails suggests one Zap and one inbound address per venue, so a group with several venues runs several Zaps.

send\_email asks for your OK by default. To run it on a schedule without you, switch confirmation off for that tool in your dashboard.

Sources: [Perfect Venue Help: Automatically Create Events from Emails with Zapier](https://help.perfectvenue.com/knowledge/automatically-create-events-from-emails-using-zapier) · [Perfect Venue Help: First Reply](https://help.perfectvenue.com/knowledge/first-reply-automated-responses-to-new-inquiries) · [Perfect Venue Help: Contact Form & Custom Fields](https://help.perfectvenue.com/knowledge/contact-form) · [Perfect Venue Help: Auto Tracking of Lead Sources](https://help.perfectvenue.com/knowledge/how-to-enabled-auto-tracking-of-leads-into-perfect-venue) · [Perfect Venue Help: Team Members](https://help.perfectvenue.com/knowledge/team-members)

REST

## Call create\_lead from a script

curl

```
curl https://cotlet.dev/api/v1/perfect-venue/create_lead \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Sam","last_name":"Rivera","email":"sam.rivera@example.com","start_date":"2026-11-14","start_time":"18:00","end_time":"22:00","group_size":40,"event_type":"Rehearsal","spaces":["sp_01"],"message":"Emailed to events@ on 12 Oct. Wants a set menu, two vegetarians."}'
```

Example response

```
{
"event_id": "ev_8841",
"status": "lead",
"start_date": "2026-11-14",
"group_size": 40,
"contact": {
"name": "Alex Client",
"email": "client@example.com"
}
}
```

MCP: add https://cotlet.dev/mcp/v1 with the same key; the tool is perfect-venue\_create\_lead. Example data.

[Schedule it in n8n, Make, Zapier or cron](https://cotlet.dev/integrations/perfect-venue-api-mcp-server#automations)

Tools

## Perfect Venue tools this automation uses

__Cotlet Perfect Venue tools used to create Perfect Venue leads from emails and phone calls__
| Tool | Parameters |
| ------------ | --------------------------------------------------------------------------------------------------------------------- |
| list\_events | status, from, to, venue\_id, owner, limit, cursor |
| list\_spaces | venue\_id |
| create\_lead | first\_name, last\_name, email, phone, start\_date, start\_time, end\_time, group\_size, event\_type, spaces, message |
| send\_email | event\_id, template\_id, subject, body |

[All 14 Perfect Venue tools with descriptions](https://cotlet.dev/integrations/perfect-venue-api-mcp-server#tools)

## Frequently asked questions

### Do I need the Enterprise plan or Zapier for this?

No. The agent works in your own Perfect Venue account through Cotlet, so it uses neither the Enterprise-only Leads API nor a Zapier plan. Your Perfect Venue user needs the Admin or Editor permission, because Viewer and Limited View cannot edit anything.

## More Perfect Venue automations

- [Follow up on unanswered Perfect Venue leads](https://cotlet.dev/integrations/perfect-venue-api-mcp-server/follow-up-on-unanswered-leads)
- [Send Perfect Venue balance due reminders](https://cotlet.dev/integrations/perfect-venue-api-mcp-server/send-balance-due-reminders)
- [Perfect Venue API and MCP server: every tool](https://cotlet.dev/integrations/perfect-venue-api-mcp-server)
- [All use cases](https://cotlet.dev/use-cases)

## Give your agent access to Perfect Venue.

Free 7-day trial with 5,000 credits, no card needed. Cotlet is independent and not affiliated with Perfect Venue.

[Request access](https://cotlet.dev/app/signup?app=perfect-venue)