> ## 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.

# Sponsors

> Query, create, and update event sponsors

## swoogo\_get\_sponsors

List or retrieve sponsors with filtering by name and sponsorship level.

### Parameters

| Parameter    | Type    | Required       | Description                               |
| ------------ | ------- | -------------- | ----------------------------------------- |
| `sponsor_id` | integer | No             | Get a single sponsor by ID                |
| `event_id`   | integer | Yes (for list) | Event to list sponsors for                |
| `name`       | string  | No             | Filter by sponsor name (partial match)    |
| `level`      | string  | No             | Filter by sponsorship level (exact match) |
| `search`     | string  | No             | Raw Swoogo search filter                  |
| `fields`     | string  | No             | Comma-separated fields to return          |
| `expand`     | string  | No             | Include related objects                   |
| `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)    |

***

## swoogo\_create\_sponsor

Add a sponsor to an event.

### Parameters

| Parameter           | Type    | Required | Description             |
| ------------------- | ------- | -------- | ----------------------- |
| `event_id`          | integer | Yes      | Event to add sponsor to |
| `name`              | string  | Yes      | Sponsor name            |
| `website`           | string  | No       | Sponsor website URL     |
| `level`             | string  | No       | Sponsorship level       |
| `logo_id`           | integer | No       | Logo image ID           |
| `description`       | string  | No       | Sponsor description     |
| `additional_fields` | object  | No       | Custom field values     |

***

## swoogo\_update\_sponsor

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

### Parameters

| Parameter           | Type    | Required | Description                   |
| ------------------- | ------- | -------- | ----------------------------- |
| `sponsor_id`        | integer | Yes      | Sponsor to update             |
| `name`              | string  | No       | New name                      |
| `website`           | string  | No       | New website URL               |
| `level`             | string  | No       | New sponsorship level         |
| `logo_id`           | integer | No       | New logo image ID             |
| `description`       | string  | No       | New description               |
| `additional_fields` | object  | No       | Custom field values to update |