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