---
title: "Sponsors"
description: "Create and update sponsors with complete curl request examples."
lastModified: "2026-08-25"
---

**Collection path:** `events/{event_id}/sponsors`

## Content-session input reference

All inputs below are configurable for both POST and PATCH unless a note says otherwise. PATCH is partial; only replacement-style nested inputs replace collections.

| Input | Type | Notes |
| :---- | :---- | :---- |
| `category_id` | Scalar ID | Required by the model; category must belong to the event. |
| `level` | Scalar string | `large`, `medium`, or `small`. |
| `position` | Scalar number or `null` | Display order. |
| `name` | Scalar string | Required by the model. |
| `subtitle` | Scalar string or `null` | Subtitle. |
| `content` | Raw JSON | DraftJS content; sanitized before storage. |
| `website` | Scalar string or `null` | Website URL. |
| `twitter` | Scalar string or `null` | Twitter/X value; normalized by the sponsor service. |
| `linkedin` | Scalar string or `null` | LinkedIn value. |
| `facebook` | Scalar string or `null` | Facebook value. |
| `instagram` | Scalar string or `null` | Instagram value. |
| `active` | JSON boolean | Active setting. |
| `industry` | Scalar number or `null` | Numeric industry code from `0` to `148`. |
| `external_id` | Scalar string or `null` | External identifier. |
| `uses_chat` | JSON boolean | Creates the sponsor chat conversation when enabled. |
| `state` | Scalar string | `active`, `passive`, or `trashed`. |
| `uses_analytics` | JSON boolean | Analytics setting. |
| `cta_text` | Scalar string or `null` | Call-to-action text. |
| `lead_scanning_enabled` | JSON boolean | Lead scanning setting. |
| `has_automatic_representatives_linking` | JSON boolean | Representative-linking setting. |
| `allows_meet_at_booth` | JSON boolean | Meet-at-booth setting; synchronized with `uses_meet_at_booth` by the model. |
| `uses_meet_at_booth` | JSON boolean | Meet-at-booth setting; synchronized with `allows_meet_at_booth`. |
| `app_sponsor` | JSON boolean | App sponsorship setting. |
| `app_sponsor_label` | Scalar string or `null` | App sponsor label. |
| `location_country` | Scalar string or `null` | Country. |
| `location_state` | Scalar string or `null` | State/region. |
| `company_domains` | Array of scalar strings | Company domains. |
| `representatives_linking_method` | Scalar string | `partial_company_name_match`, `exact_company_name_match`, or `company_domain_match`. The model/default must provide one. |
| `meeting_cap` | Scalar number or `null` | Meeting cap. |
| `map_link` | Scalar string or `null` | Map URL. |
| `show_sponsored_session_rsvps` | JSON boolean | Sponsored-session RSVP visibility. |
| `logo` | Scalar string | Base64 data URI. Blank on PATCH removes the image. |
| `cover_image` | Scalar string | Base64 data URI. Blank on PATCH removes the image. |
| `app_sponsor_image` | Scalar string | Base64 data URI. Blank on PATCH removes the image. |
| `custom_fields_attributes` | Raw array | Entries use `key` plus `value` or `values`. |
| `selected_interests` | Raw array | Entries use `interest_id` and `intent_ids`. PATCH removes selections not present in the supplied array. |
| `media` | Raw object | Supports `deck_slides` and `sidebar_tabs` arrays; both are replacement-style when supplied. |
| `products` | Raw array | Full product replacement by title when supplied; each entry supports `title`, `description`, `url`, and optional image. |
| `booth_tabs` | Raw array | Stored tab configuration. Exposed response keys are `key`, `title`, and `position`; duplicate keys are collapsed. |

A scope restricted to existing sponsor IDs cannot create sponsors. It can patch only sponsors in the restricted set.

## POST a sponsor

```shell
curl --request POST \
  --url "${BRELLA_API_BASE_URL}/api/core/organizations/${BRELLA_ORGANIZATION_ID}/events/${BRELLA_EVENT_ID}/sponsors" \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "name": "Example Ltd",
    "category_id": 51,
    "level": "large",
    "position": 10,
    "active": true,
    "state": "active",
    "website": "https://example.com",
    "company_domains": ["example.com"],
    "lead_scanning_enabled": true,
    "uses_chat": true,
    "custom_fields_attributes": [
      { "key": "company_size", "values": ["51-200"] }
    ],
    "selected_interests": [
      { "interest_id": 701, "intent_ids": [801] }
    ],
    "products": [
      {
        "title": "Example Platform",
        "description": "Product overview",
        "url": "https://example.com/platform"
      }
    ],
    "media": {
      "deck_slides": [
        {
          "title": "Platform overview",
          "url": "https://example.com/deck",
          "body_type": "iframe"
        }
      ],
      "sidebar_tabs": [
        {
          "title": "Book a demo",
          "url": "https://example.com/demo"
        }
      ]
    },
    "booth_tabs": [
      { "key": "overview", "title": "Overview", "position": 1 }
    ]
  }'
```

The response type is `sponsor`. Useful write-response fields include `category_id`, `name`, `state`, `external_id`, `company_domains`, `logo_url`, `booth_tabs`, and `updated_at`.

## PATCH a sponsor

This example changes scalar fields and fully replaces the product list. Omitting `products` would preserve the current products.

```shell
curl --request PATCH \
  --url "${BRELLA_API_BASE_URL}/api/core/organizations/${BRELLA_ORGANIZATION_ID}/events/${BRELLA_EVENT_ID}/sponsors/103705" \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "subtitle": "Partnership platform",
    "cta_text": "Book a demo",
    "company_domains": ["example.com", "example.org"],
    "products": [
      {
        "title": "Example Platform",
        "description": "Updated product overview",
        "url": "https://example.com/platform"
      },
      {
        "title": "Example Analytics",
        "description": "Sponsor analytics add-on",
        "url": "https://example.com/analytics"
      }
    ]
  }'
```