> ## Documentation Index
> Fetch the complete documentation index at: https://developer.swoogo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Speakers

> Query, create, and update event speakers

## swoogo\_get\_speakers

List or retrieve speakers with filtering by name and company.

### Parameters

| Parameter    | Type    | Required       | Description                              |
| ------------ | ------- | -------------- | ---------------------------------------- |
| `speaker_id` | integer | No             | Get a single speaker by ID               |
| `event_id`   | integer | Yes (for list) | Event to list speakers for               |
| `name`       | string  | No             | Filter by speaker name (partial match)   |
| `company`    | string  | No             | Filter by company name                   |
| `search`     | string  | No             | Raw Swoogo search filter                 |
| `fields`     | string  | No             | Comma-separated fields to return         |
| `expand`     | string  | No             | Include related objects (`sessions`)     |
| `page`       | integer | No             | Page number (default: 1)                 |
| `per_page`   | integer | No             | Results per page (default: 20, max: 100) |
| `sort`       | string  | No             | Sort field (prefix `-` for descending)   |

### Example prompts

* *"Who are the speakers for event 12345?"*
* *"Find speakers from Google"*

***

## swoogo\_create\_speaker

Add a speaker to an event.

### Parameters

| Parameter           | Type    | Required | Description             |
| ------------------- | ------- | -------- | ----------------------- |
| `event_id`          | integer | Yes      | Event to add speaker to |
| `email`             | string  | Yes      | Speaker email address   |
| `first_name`        | string  | No       | First name              |
| `last_name`         | string  | No       | Last name               |
| `company`           | string  | No       | Company name            |
| `job_title`         | string  | No       | Job title               |
| `bio`               | string  | No       | Speaker biography       |
| `additional_fields` | object  | No       | Custom field values     |

***

## swoogo\_update\_speaker

Update an existing speaker. Only the fields you provide will be changed.

### Parameters

| Parameter           | Type    | Required | Description                   |
| ------------------- | ------- | -------- | ----------------------------- |
| `speaker_id`        | integer | Yes      | Speaker to update             |
| `email`             | string  | No       | New email                     |
| `first_name`        | string  | No       | New first name                |
| `last_name`         | string  | No       | New last name                 |
| `company`           | string  | No       | New company                   |
| `job_title`         | string  | No       | New job title                 |
| `bio`               | string  | No       | New biography                 |
| `additional_fields` | object  | No       | Custom field values to update |