---
title: "Sponsor ads"
description: "Sponsor ads: available fields, filters, associations, and API operations."
lastModified: "2026-08-21"
---

**Path:** `events/{event_id}/sponsor-ads`  
**Methods:** GET collection/record, POST, PATCH. There is no DELETE operation; use `archived` on PATCH.

**GET**

- Fields: `event-id`, `sponsor-id`, `pitch`, `image-url`, `cover-image-url`, `featured-tile-image-url`, `featured-tile-text`, `display-share`, `display-count`, `collection-display-count`, `archived-at`, `registrant-id`, `created-at`, `updated-at`, `clicks-count`, `unique-click-registrants-count`, `clicks-by-day`.  
- Filters: `sponsor_id`, `active`, `created_from`, `created_to`.  
- Association: `sponsor`, linkage only.  
- Row restriction: by the `sponsor` association.

```
GET .../sponsor-ads?sponsor_id=103705&active=true
```

**POST** requires `sponsor_id`. Other inputs are `pitch`, `featured_tile_text`, `display_share`, `image`, `cover_image`, and `featured_tile_image`.

```json
{
  "sponsor_id": 103705,
  "pitch": "Meet the team",
  "featured_tile_text": "Visit our booth",
  "display_share": 20,
  "image": "data:image/png;base64,..."
}
```

**PATCH** accepts `pitch`, `featured_tile_text`, `display_share`, `image`, `cover_image`, `featured_tile_image`, and `archived`.

```json
{ "archived": true }
```

Archiving sets `archived-at` and forces `display-share` to zero. `archived: false` restores the record. Image inputs accept base64 data URIs; a blank image value on PATCH removes that image. Sponsor restrictions apply to reads and writes.