Sponsor ads

Create and update sponsor ads with complete curl request examples.

Collection path: events/{event_id}/sponsor-ads

Input	Type	POST	PATCH	Notes
`sponsor_id`	Scalar ID	Required	Ignored	Sponsor must belong to the event and satisfy any sponsor association restriction.
`pitch`	Scalar string or `null`	Optional	Optional	Ad pitch.
`featured_tile_text`	Scalar string or `null`	Optional	Optional	Featured-tile text.
`display_share`	Scalar number	Optional; defaults to `0`	Optional	Event-level display-share validation applies.
`image`	Scalar string	Optional	Optional	Base64 data URI. Blank on PATCH removes the image.
`cover_image`	Scalar string	Optional	Optional	Base64 data URI. Blank on PATCH removes the image.
`featured_tile_image`	Scalar string	Optional	Optional	Base64 data URI. Blank on PATCH removes the image.
`archived`	JSON boolean	Ignored	Optional	True archives and sets display share to zero; false restores the record.

Replace <BASE64_DATA> with the actual base64 payload, without angle brackets.

curl --request POST \
  --url "${BRELLA_API_BASE_URL}/api/core/organizations/${BRELLA_ORGANIZATION_ID}/events/${BRELLA_EVENT_ID}/sponsor-ads" \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "sponsor_id": 103705,
    "pitch": "Meet the team",
    "featured_tile_text": "Visit our booth",
    "display_share": 20,
    "image": "data:image/png;base64,<BASE64_DATA>"
  }'

The response type is sponsor-ad. Useful write-response fields include sponsor_id, pitch, featured_tile_text, display_share, image_url, deleted_at (returned as archived-at), and updated_at.

The sponsor cannot be changed after creation. This example updates display content:

curl --request PATCH \
  --url "${BRELLA_API_BASE_URL}/api/core/organizations/${BRELLA_ORGANIZATION_ID}/events/${BRELLA_EVENT_ID}/sponsor-ads/9401" \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "pitch": "Meet the partnerships team",
    "featured_tile_text": "Book a booth meeting",
    "display_share": 15
  }'

Archive through PATCH because this resource has no delete mutation:

curl --request PATCH \
  --url "${BRELLA_API_BASE_URL}/api/core/organizations/${BRELLA_ORGANIZATION_ID}/events/${BRELLA_EVENT_ID}/sponsor-ads/9401" \
  --header "Accept: application/vnd.brella.v4+json" \
  --header "Brella-API-Access-Token: ${BRELLA_API_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "archived": true
  }'

Sponsor ads

POST a sponsor ad

PATCH a sponsor ad