> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Eventzilla

The Eventzilla connector lets your AI agent act in each user's Eventzilla account. Each user connects their own Eventzilla API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 20 tools.

**Authentication:** API Key
**Categories:** Calendar, Marketing
**Tools:** 20: 11 read, 8 write, 1 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=EVENTZILLA)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Eventzilla connection

   In **AgentKit > Connections**, create an Eventzilla connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'eventzilla'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Eventzilla:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'eventzilla_categories_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "eventzilla"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Eventzilla:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="eventzilla_categories_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Eventzilla credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'eventzilla_attendee_get',
  toolInput: {
    attendee_id: 2139001122,
  },
  connector: 'eventzilla',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="eventzilla_attendee_get",
    tool_input={
        "attendee_id": 2139001122,
    },
    connection_name="eventzilla",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `eventzilla_attendee_get`

Get Attendee · Read-only

Get the details of one Eventzilla attendee.
Returns the attendee's name, email, ticket type, barcode, check-in status, order details and registration answers.
Use eventzilla_event_attendees_list to find attendee IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `attendee_id` (`integer`, required): Attendee ID, from eventzilla_event_attendees_list. Example: 2139001122.

Example input: `{"attendee_id":2139001122}`

### `eventzilla_categories_list`

List Event Categories · Read-only

List the event categories available in your Eventzilla account.
Returns the category names.
Use this to get a category value for eventzilla_events_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `eventzilla_checkout_prepare`

Prepare Checkout · Read-only

Get what is needed to register for one Eventzilla event date: ticket types and prices, registration questions and payment options.
Returns ticket types, questions and payment option IDs.
Use this first in the checkout flow, then eventzilla_checkout_create, eventzilla_checkout_fill_order and eventzilla_checkout_confirm.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `event_date_id` (`integer`, required): ID of the event date (occurrence). Get it from eventzilla_event_get. Example: 2138985706.
- `event_id` (`integer`, required): Eventzilla event ID. Get it from eventzilla_events_list. Example: 2138988852.

Example input: `{"event_date_id":2138985706,"event_id":2138988852}`

### `eventzilla_event_attendees_list`

List Event Attendees · Read-only

List the attendees registered for one Eventzilla event.
Returns attendees with ID, name, email, ticket type, barcode, check-in status and order reference.
Use this to see who is coming. Use eventzilla_attendee_get for one attendee's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `event_id` (`integer`, required): Eventzilla event ID. Get it from eventzilla_events_list. Example: 2138988852.

Example input: `{"event_id":2138988852}`

### `eventzilla_event_get`

Get Event · Read-only

Get the details of one Eventzilla event.
Returns the event's title, description, status, dates and date IDs, timezone, venue, URLs and sales settings.
Use this for one event's date IDs before eventzilla_checkout_prepare. Use eventzilla_events_list to find events.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `event_id` (`integer`, required): Eventzilla event ID. Get it from eventzilla_events_list. Example: 2138988852.

Example input: `{"event_id":2138988852}`

### `eventzilla_event_ticket_types_list`

List Event Ticket Types · Read-only

List the ticket types of one Eventzilla event.
Returns each ticket type's ID, name, price, quantity, sales window and visibility.
Use this for ticket type IDs before eventzilla_checkout_create or eventzilla_ticket_type_update.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `event_id` (`integer`, required): Eventzilla event ID. Get it from eventzilla_events_list. Example: 2138988852.

Example input: `{"event_id":2138988852}`

### `eventzilla_event_transactions_list`

List Event Transactions · Read-only

List the orders (transactions) placed for one Eventzilla event.
Returns transactions with checkout ID, reference number, buyer, amounts, payment status and ticket counts.
Use this to review an event's sales. Use eventzilla_transaction_get for one order by checkout ID or reference.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `event_id` (`integer`, required): Eventzilla event ID. Get it from eventzilla_events_list. Example: 2138988852.
- `limit` (`integer`, optional): Maximum number of records to return. Defaults to 20. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Defaults to 0. Example: 0.

Example input: `{"event_id":2138988852}`

### `eventzilla_events_list`

List Events · Read-only

List the events in your Eventzilla account, optionally filtered by status or category.
Returns events with id, title, status, category, dates, venue and ticket sales details, plus pagination.
Use this to find an event ID. Use eventzilla_event_get for one event's full details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `category` (`string`, optional): Filter by category name. Get names from eventzilla_categories_list. Example: music.
- `limit` (`integer`, optional): Maximum number of records to return. Defaults to 20. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Defaults to 0. Example: 0.
- `status` (`string`, optional): Filter by event status, such as live, draft, unpublished or completed. Example: live.

Example input: `{}`

### `eventzilla_transaction_get`

Get Transaction · Read-only

Get one Eventzilla order (transaction) by checkout ID or order reference number.
Returns the order's buyer, event, tickets, amounts and payment status.
Use this to look up a specific order. Use eventzilla_event_transactions_list to browse an event's orders.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `identifier` (`string`, required): Checkout ID or order reference number. Example: 21388601015.

Example input: `{"identifier":"<identifier>"}`

### `eventzilla_user_get`

Get User · Read-only

Get the details of one Eventzilla user (organizer).
Returns the user's ID, name, email and organization details.
Use eventzilla_users_list to find user IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `user_id` (`integer`, required): User (organizer) ID, from eventzilla_users_list. Example: 2138000001.

Example input: `{"user_id":2138000001}`

### `eventzilla_users_list`

List Users · Read-only

List the users (organizers) on your Eventzilla account.
Returns users with ID, name, email and role.
Use eventzilla_user_get for one user's details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of records to return. Defaults to 20. Example: 20.
- `offset` (`integer`, optional): Number of records to skip, for paging. Defaults to 0. Example: 0.

Example input: `{}`

### `eventzilla_attendee_checkin`

Check In Attendee · Write

Check an attendee in to an Eventzilla event by ticket barcode, or undo a check-in.
Returns the attendee's check-in result.
Use this at the door. Get barcodes from eventzilla_event_attendees_list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `barcode` (`string`, required): Barcode on the attendee's ticket. Example: EZ202605200001.
- `eventcheckin` (`boolean`, required): true to check the attendee in, false to revert the check-in. Example: true.

Example input: `{"barcode":"<barcode>","eventcheckin":true}`

### `eventzilla_checkout_confirm`

Confirm Checkout Order · Write

Confirm an Eventzilla checkout order and issue its tickets.
Returns the confirmed order with its reference number.
Use this last in the checkout flow, after eventzilla_checkout_fill_order.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `checkout_id` (`integer`, required): Checkout (order) ID, from eventzilla_checkout_create or eventzilla_event_transactions_list. Example: 21388601015.
- `event_date_id` (`integer`, required): ID of the event date (occurrence). Get it from eventzilla_event_get. Example: 2138985706.
- `event_id` (`integer`, required): Eventzilla event ID. Get it from eventzilla_events_list. Example: 2138988852.
- `payment_status` (`string`, required): Payment status for the order. Eventzilla's example uses success for a completed payment. Example: success.
- `comments` (`string`, optional): Comment stored with the confirmation. Example: Registered by agent.
- `sendemail` (`boolean`, optional): Whether Eventzilla emails the confirmation and tickets. Example: true.

Example input: `{"checkout_id":21388601015,"event_date_id":2138985706,"event_id":2138988852,"payment_status":"<payment_status>"}`

### `eventzilla_checkout_create`

Create Checkout Order · Write

Start a registration by reserving tickets for an Eventzilla event date.
Returns the new checkout_id and the ticket price IDs to fill in.
Use this after eventzilla_checkout_prepare. Then call eventzilla_checkout_fill_order.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `event_date_id` (`integer`, required): ID of the event date (occurrence). Get it from eventzilla_event_get. Example: 2138985706.
- `event_id` (`integer`, required): Eventzilla event ID. Get it from eventzilla_events_list. Example: 2138988852.
- `ticket_types` (`array`, required): Ticket types and quantities to reserve. Each item has a ticket_type_id and a quantity. Example: [{"ticket_type_id": 2138120411, "quantity": 2}]
- `discount_code` (`string`, optional): Discount code to apply. Example: SAAS20.

Example input: `{"event_date_id":2138985706,"event_id":2138988852,"ticket_types":[{"ticket_type_id":2138120411,"quantity":2}]}`

### `eventzilla_checkout_fill_order`

Fill Checkout Order · Write

Add buyer and attendee details to an Eventzilla checkout and choose the payment option.
Returns the updated order.
Use this after eventzilla_checkout_create. Then call eventzilla_checkout_confirm.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `buyerdetails` (`array`, required): The buyer, as one object with first name, last name and email. Example: [{"buyer_firstname": "Amelia", "buyer_lastname": "Chen", "buyer_email": "amelia.chen@example.com"}]
- `checkout_id` (`integer`, required): Checkout (order) ID, from eventzilla_checkout_create or eventzilla_event_transactions_list. Example: 21388601015.
- `event_date_id` (`integer`, required): ID of the event date (occurrence). Get it from eventzilla_event_get. Example: 2138985706.
- `event_id` (`integer`, required): Eventzilla event ID. Get it from eventzilla_events_list. Example: 2138988852.
- `payment_id` (`integer`, required): Payment option ID, from eventzilla_checkout_prepare. Example: 2138979179.
- `tickets` (`array`, required): One object per ticket: the ticket_price_id from the checkout, the attendee's first and last name and email, and answers to registration questions (question_id and answer_text). Example: [{"ticket_price_id": 1362622, "first_name": "Amelia", "last_name": "Chen", "email": "amelia.chen@example.com", "answers": [{"question_id": 2138360281, "answe...

Example input: `{"buyerdetails":[{"buyer_firstname":"Amelia","buyer_lastname":"Chen","buyer_email":"amelia.chen@example.com"}],"checkout_id":21388601015,"event_date_id":2138985706,"event_id":2138988852,"payment_id":2138979179,"tickets":[]}`

### `eventzilla_event_sales_toggle`

Toggle Event Sales · Write

Turn ticket sales on or off for an Eventzilla event.
Returns the result of the change.
Use this to open or pause registration. Use eventzilla_event_get to check the event first.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `event_id` (`integer`, required): Eventzilla event ID. Get it from eventzilla_events_list. Example: 2138988852.
- `status` (`boolean`, required): true to publish (open) ticket sales, false to unpublish (stop) them. Example: true.

Example input: `{"event_id":2138988852,"status":true}`

### `eventzilla_order_confirm`

Confirm Event Order · Write

Confirm a pending order (for example an offline or invoice payment) for an Eventzilla event.
Returns the result of the confirmation.
Use this after payment is received. Use eventzilla_checkout_confirm to finish an order created through the checkout tools.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checkout_id` (`integer`, required): Checkout (order) ID, from eventzilla_checkout_create or eventzilla_event_transactions_list. Example: 21388601015.
- `comments` (`string`, required): Organizer comment for the confirmation. Example: Payment received by bank transfer.
- `event_id` (`integer`, required): Eventzilla event ID. Get it from eventzilla_events_list. Example: 2138988852.
- `sendemail` (`boolean`, optional): Whether Eventzilla emails the buyer a notification. Example: true.

Example input: `{"checkout_id":21388601015,"comments":"<comments>","event_id":2138988852}`

### `eventzilla_ticket_type_create`

Create Free Ticket Type · Write

Create a free ticket type on an Eventzilla event.
Returns the new ticket type with its ID.
Use this to add a free admission tier. Use eventzilla_ticket_type_update to change an existing one.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `boxoffice_only` (`boolean`, required): Whether the ticket type is sold only through the box office. Example: false.
- `event_id` (`integer`, required): Eventzilla event ID. Get it from eventzilla_events_list. Example: 2138988852.
- `is_visible` (`boolean`, required): Whether the ticket type shows on the event registration page. Example: true.
- `limit_maximum` (`integer`, required): Maximum tickets of this type per order. Example: 10.
- `limit_minimum` (`integer`, required): Minimum tickets of this type per order. Example: 1.
- `quantity_total` (`integer`, required): Total number of tickets available. Example: 100.
- `sales_end_date` (`string`, required): Date ticket sales close, as YYYY-MM-DD. Example: 2026-04-20.
- `sales_end_time` (`string`, required): Time ticket sales close, as HH:MM (24-hour). Example: 18:00.
- `sales_start_date` (`string`, required): Date ticket sales open, as YYYY-MM-DD. Example: 2026-02-05.
- `sales_start_time` (`string`, required): Time ticket sales open, as HH:MM (24-hour). Example: 09:00.
- `ticket_type_description` (`string`, required): Public description shown to attendees. Example: Entry to all sessions on day one.
- `ticket_type_name` (`string`, required): Name shown for the ticket type. Example: Early bird admission.
- `additional_instructions` (`string`, optional): Instructions shown to attendees after registration or on their ticket. Example: Bring photo ID to the registration desk.
- `unlock_code` (`string`, optional): Code buyers must enter to unlock this ticket type. Example: VIP2026.

Example input: `{"boxoffice_only":true,"event_id":2138988852,"is_visible":true,"limit_maximum":10,"limit_minimum":1,"quantity_total":100,"sales_end_date":"<sales_end_date>","sales_end_time":"<sales_end_time>","sales_start_date":"<sales_start_date>","sales_start_time":"<sales_start_time>","ticket_type_description":"<ticket_type_description>","ticket_type_name":"<ticket_type_name>"}`

### `eventzilla_ticket_type_update`

Update Free Ticket Type · Write

Update a free ticket type on an Eventzilla event. Send every field, not only the ones that change.
Returns the updated ticket type.
Use eventzilla_event_ticket_types_list first to read the current values and the ticket type ID.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `boxoffice_only` (`boolean`, required): Whether the ticket type is sold only through the box office. Example: false.
- `event_id` (`integer`, required): Eventzilla event ID. Get it from eventzilla_events_list. Example: 2138988852.
- `is_visible` (`boolean`, required): Whether the ticket type shows on the event registration page. Example: true.
- `limit_maximum` (`integer`, required): Maximum tickets of this type per order. Example: 10.
- `limit_minimum` (`integer`, required): Minimum tickets of this type per order. Example: 1.
- `quantity_total` (`integer`, required): Total number of tickets available. Example: 100.
- `sales_end_date` (`string`, required): Date ticket sales close, as YYYY-MM-DD. Example: 2026-04-20.
- `sales_end_time` (`string`, required): Time ticket sales close, as HH:MM (24-hour). Example: 18:00.
- `sales_start_date` (`string`, required): Date ticket sales open, as YYYY-MM-DD. Example: 2026-02-05.
- `sales_start_time` (`string`, required): Time ticket sales open, as HH:MM (24-hour). Example: 09:00.
- `ticket_type_description` (`string`, required): Public description shown to attendees. Example: Entry to all sessions on day one.
- `ticket_type_id` (`integer`, required): Ticket type ID, from eventzilla_event_ticket_types_list. Example: 2138120411.
- `ticket_type_name` (`string`, required): Name shown for the ticket type. Example: Early bird admission.
- `additional_instructions` (`string`, optional): Instructions shown to attendees after registration or on their ticket. Example: Bring photo ID to the registration desk.
- `unlock_code` (`string`, optional): Code buyers must enter to unlock this ticket type. Example: VIP2026.

Example input: `{"boxoffice_only":true,"event_id":2138988852,"is_visible":true,"limit_maximum":10,"limit_minimum":1,"quantity_total":100,"sales_end_date":"<sales_end_date>","sales_end_time":"<sales_end_time>","sales_start_date":"<sales_start_date>","sales_start_time":"<sales_start_time>","ticket_type_description":"<ticket_type_description>","ticket_type_id":2138120411,"ticket_type_name":"<ticket_type_name>"}`

### `eventzilla_order_cancel`

Cancel Event Order · Destructive

Cancel an order (checkout) for an Eventzilla event.
Returns the result of the cancellation.
Use this to cancel a buyer's registration. Use eventzilla_order_confirm to confirm a pending order instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `checkout_id` (`integer`, required): Checkout (order) ID, from eventzilla_checkout_create or eventzilla_event_transactions_list. Example: 21388601015.
- `comments` (`string`, required): Organizer comment explaining the cancellation. Example: Cancelled at the buyer's request.
- `event_id` (`integer`, required): Eventzilla event ID. Get it from eventzilla_events_list. Example: 2138988852.

Example input: `{"checkout_id":21388601015,"comments":"<comments>","event_id":2138988852}`

## Related

Other Calendar connectors ([all 25](/agentkit/connectors/?category=calendar)):

- [Google Calendar](/agentkit/connectors/googlecalendar/): Scalekit connector, OAuth, 30 tools
- [Zoom](/agentkit/connectors/zoom/): Scalekit connector, OAuth, 58 tools
- [Calendly](/agentkit/connectors/calendly/): Scalekit connector, OAuth, 64 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
