Skip to content
Core API
Esc
navigateopen⌘Jpreview
On this page

Sponsors

Create and update sponsors with complete curl request examples.

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

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.

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"
      }
    ]
  }'

Last updated on August 25, 2026