Sponsors

Sponsors: available fields, filters, associations, and API operations.

Operations

curl --fail-with-body --silent --show-error --globoff --max-time 30 --request GET \
  --url "${BRELLA_API_BASE_URL}"'/api/core/organizations/123/events/456/sponsors' \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}"

{
  "data": [
    {
      "id": "1201",
      "type": "sponsor"
    }
  ],
  "meta": {
    "total_count": 1,
    "total_pages": 1,
    "current_page": 1
  }
}

curl --fail-with-body --silent --show-error --globoff --max-time 30 --request GET \
  --url "${BRELLA_API_BASE_URL}"'/api/core/organizations/123/events/456/sponsors/1201' \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}"

{
  "data": {
    "id": "1201",
    "type": "sponsor"
  }
}

curl --fail-with-body --silent --show-error --globoff --max-time 30 --request POST \
  --url "${BRELLA_API_BASE_URL}"'/api/core/organizations/123/events/456/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"
}'

{
  "data": {
    "id": "1201",
    "type": "sponsor"
  }
}

curl --fail-with-body --silent --show-error --globoff --max-time 30 --request PATCH \
  --url "${BRELLA_API_BASE_URL}"'/api/core/organizations/123/events/456/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"
    }
  ]
}'

{
  "data": {
    "id": "1201",
    "type": "sponsor"
  }
}

curl --fail-with-body --silent --show-error --globoff --max-time 30 --request DELETE \
  --url "${BRELLA_API_BASE_URL}"'/api/core/organizations/123/events/456/sponsors/1201' \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}"

Path: events/{event_id}/sponsors
Methods: GET collection/record, POST, PATCH, DELETE.

Fields, filters and associations

• Filters: name, external_id, state, category_id, level, main_sponsored_session_id, session_sponsored_session_id.
• Row restrictions: primary sponsor IDs, field state, or association category. A primary-ID-restricted scope cannot create sponsors.
• Associations:
  • category: name, level, position, external-id, allows-meet-at-booth, sponsors-count;
  • sponsor_admins → sponsor-admins: email, invitation-used-at;
  • ads: pitch, image-url, cover-image-url, featured-tile-image-url, featured-tile-text, display-share, display-count, collection-display-count, archived-at, registrant-id, clicks-count, unique-click-registrants-count, clicks-by-day, created-at, updated-at;
  • banner_ads → banner-ads: title, position, image-url, sponsor-id, display-count, archived-at, clicks-count, clicks-by-day, created-at, updated-at;
  • products: title, description, position, image-url, url, created-at, updated-at;
  • downloads: title, description, position, attachment-type, attachment-url, file-url, enabled, created-at, updated-at;
  • deck_media → deck-media, plus attachments, tabs, and media: position, body-type, title, url, image-url, mime-type, description, cta-text, created-at, updated-at;
  • session_sponsors → session-sponsorships: timeslot-id, position, label, title, start-time, end-time;
  • locations → singular response booth-location: name, color, location-type;
  • selected_interests → interests: interest-id, interest-name, intent-id, intent-label;
  • custom_fields → custom-fields: definition-key, definition-title, field-type, values.

sponsor_admins is organizer-only and is suppressed for primary-sponsor-restricted scopes even if configured.

GET .../sponsors?state=active&include=category,products,locations,session-sponsors

Writing this resource

Writable fields: category_id, level, position, name, subtitle, content (raw JSON), website, twitter, linkedin, facebook, instagram, active, industry, external_id, uses_chat, state, uses_analytics, cta_text, lead_scanning_enabled, has_automatic_representatives_linking, allows_meet_at_booth, uses_meet_at_booth, app_sponsor, app_sponsor_label, location_country, location_state, company_domains (array), representatives_linking_method, meeting_cap, map_link, show_sponsored_session_rsvps.

Additional inputs: logo, cover_image, app_sponsor_image, custom_fields_attributes (raw JSON), selected_interests (raw JSON), media (raw JSON), products (raw JSON), booth_tabs (raw JSON).

{
  "name": "Example Ltd",
  "category_id": 51,
  "level": "large",
  "active": true,
  "state": "active",
  "website": "https://example.com",
  "company_domains": ["example.com"],
  "products": [
    { "title": "Example Platform", "description": "Product overview", "position": 1 }
  ],
  "booth_tabs": [
    { "key": "overview", "title": "Overview", "position": 1 }
  ]
}

The category must belong to the event; use sponsor categories to read or manage it. Image inputs accept base64 data URIs; a blank image value on PATCH removes the image. products is a full replacement when supplied. Booth tabs expose only key, title, and position. Sponsor content is sanitized before storage.