Create sponsor
2 min
WARNING! Due to a sporadic bug, you should leave at least 0.5 seconds between requests to this endpoint — unless you are explicitly specifying "position" for each sponsor. Failure to do so may result in some requests failing with a 500 Server Error. This notice will be updated once the bug is fixed.
Create new sponsor
Create a new sponsor in an event
POST
https://api.brella.io/api/integration/organizations/{organizationId}/events/{eventId}/sponsors/
Path Parameters
- {organizationId}NumberrequiredDescription
- {eventId}NumberrequiredDescription
Header Parameters
- Brella-API-Access-TokenStringrequiredDescription
- AcceptstringrequiredDescription
- Content-TypestringrequiredDescription
curl
curl --location -g --request POST 'https://api.brella.io/api/integration/organizations/{organizationId}/events/{eventId}/sponsors/' \
--header 'Brella-API-Access-Token: String' \
--header 'Accept: application/vnd.brella.v4+json' \
--header 'Content-Type: application/json'\
--data '{
"sponsor": {
"category_id": "{{category_id}}",
"position": "{{position_id}}",
"uses_chat": true,
"uses_analytics": true,
"lead_scanning_enabled":true,
"name": "{{random_company_name}}",
"subtitle": "{{random_subtitle}},
"logo": "{{logo_url}}",
"cover_image": "{{cover_image_url}}",
"cta_text": "{{some_cta_text}}",
"facebook": "{{facebook_page_url}}",
"twitter": "{{twitter_url}}",
"external_id":{{external_id}}
"linkedin": "{{linkedin_url}}",
"instagram": "{{instagram_url}}",
"website": "{{website_url}}",
"industry": "{{random_company}}",
"has_automatic_representatives_linking": "{{boolean}}",
"company_domains":["abc.com","xyz.io"],
"representatives_linking_method":"{{random_option}}",
"content":"{{rich_text_content}}",
"custom_fields_attributes": [
{
"key": "key1",
"value": "Value 1"
},
{
"key": "key2",
"value": "Value 2"
}
],
"interest_categories": [
{
"name": "a MM Category",
"interests": [
{
"name": "My first interest"
},
{
"name": "My second interest"
},
{
"name": "Oooh another Interest"
}
]
}],
"products": [
{
"title": "My first product",
"description": "Describing my truly excellent, fantabulous product",
"url": "https://mywebsite.com/product-listing/truly-excellent",
"image": "https://cyclops-ui.com/img/cyclops-simplistic.png"
},
{
"title": "A cooler second product",
"description": "Describing my truly excellent, fantabulous product v2",
"url": "https://mywebsite.com/product-listing/truly-excellent-2",
"image": "https://cyclops-ui.com/img/cyclops-simplistic.png"
}
],
"media": {
"deck_slides": [
{
"title": "Slide Title CHANGED-LAST",
"url": "https://ssec.si.edu/sites/default/files/blogpost/images/BUTTERFLY%20WING%20OPTICS.png",
"body_type": "image"
},
{
"title": "Slide Title CHANGED",
"url": "https://ssec.si.edu/sites/default/files/blogpost/images/BUTTERFLY%20WING%20OPTICS.png",
"body_type": "image"
},
{
"title": "Slide Title 2-LAST",
"url": "https://hubspot.com/",
"body_type": "iframe"
},
{
"title": "Slide Title 2",
"url": "https://hubspot.com",
"body_type": "iframe"
}
],
"sidebar_tabs": [
{
"title": "Tab 3xxxxxxxx-LAST",
"url": "https://brella.io"
},
{
"title": "Tab 3xxxxxxxx",
"url": "https://brella.io/"
}
]
}
}
}'200
{
"data": {
"id": "3188",
"type": "sponsor",
"attributes": {
"id": 3188,
"external-id": null,
"name": "Brella",
"order": null,
"logo-url": "https://brella-tester.brella.io/uploaded/sponsor/logo/3188/a7d303b3a5e4b.png",
"cover-image-url": null,
"website": "https://brella.io",
"twitter": "brellanetwork",
"linkedin": "https://www.linkedin.com/company/brellanetwork/",
"facebook": "https://www.facebook.com/Brellanetwork/",
"instagram": "@brellanetwork",
"subtitle": "Boost your Virtual Experience with us!",
"industry": 39,
"position": 1,
"content": {
"blocks": [
{
"key": "fjhrv",
"text": "Brella is a networking tool for events, conferences and livestreams. It helps professionals to find the most interesting people and make new high value contacts.",
"type": "unstyled",
"depth": 0,
"inline_style_ranges": [
{
"offset": 0,
"length": 161,
"style": "color-rgba(0,0,0,0.65)"
},
{
"offset": 0,
"length": 161,
"style": "bgcolor-rgb(255,255,255)"
},
{
"offset": 0,
"length": 161,
"style": "fontsize-14"
},
{
"offset": 0,
"length": 161,
"style": "fontfamily--apple-system, system-ui, \"Segoe UI\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei\", \"Helvetica Neue\", Helvetica, Arial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol"
}
],
"entity_ranges": [],
"data": {
"text_align": "start"
}
},
{
"key": "8t2ak",
"text": "Why do you need an event networking application? Watch the video here: Brella Video",
"type": "unstyled",
"depth": 0,
"inline_style_ranges": [
{
"offset": 0,
"length": 83,
"style": "color-rgba(0,0,0,0.65)"
},
{
"offset": 0,
"length": 83,
"style": "bgcolor-rgb(255,255,255)"
},
{
"offset": 0,
"length": 83,
"style": "fontsize-14"
},
{
"offset": 0,
"length": 83,
"style": "fontfamily--apple-system, system-ui, \"Segoe UI\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei\", \"Helvetica Neue\", Helvetica, Arial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol"
},
{
"offset": 71,
"length": 12,
"style": "color-rgb(187,22,163)"
},
{
"offset": 71,
"length": 12,
"style": "bgcolor-initial"
}
],
"entity_ranges": [
{
"offset": 71,
"length": 12,
"key": 0
}
],
"data": {
"text_align": "left"
}
},
{
"key": "do17u",
"text": "Your attendees want to learn from the best and grow their networks. But as event participation increases, your attendees work harder and harder to find relevant connections.",
"type": "unstyled",
"depth": 0,
"inline_style_ranges": [
{
"offset": 0,
"length": 173,
"style": "color-rgba(0,0,0,0.65)"
},
{
"offset": 0,
"length": 173,
"style": "bgcolor-rgb(255,255,255)"
},
{
"offset": 0,
"length": 173,
"style": "fontsize-14"
},
{
"offset": 0,
"length": 173,
"style": "fontfamily--apple-system, system-ui, \"Segoe UI\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei\", \"Helvetica Neue\", Helvetica, Arial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol"
}
],
"entity_ranges": [],
"data": {}
},
{
"key": "egbi4",
"text": "Using an event networking application simplifies the networking process. Your attendees use their time before your event to book meetings with the most relevant people for their business. This means they’re more engaged at your event.",
"type": "unstyled",
"depth": 0,
"inline_style_ranges": [
{
"offset": 0,
"length": 234,
"style": "color-rgba(0,0,0,0.65)"
},
{
"offset": 0,
"length": 234,
"style": "bgcolor-rgb(255,255,255)"
},
{
"offset": 0,
"length": 234,
"style": "fontsize-14"
},
{
"offset": 0,
"length": 234,
"style": "fontfamily--apple-system, system-ui, \"Segoe UI\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei\", \"Helvetica Neue\", Helvetica, Arial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol"
}
],
"entity_ranges": [],
"data": {
"text_align": "left"
}
},
{
"key": "b2tl8",
"text": "You also benefit as your attendees network. We help you stay on top of the trends by giving you a detailed interest overview after your event. Once you know what your attendees actually want, it’s a cinch to improve your next event.",
"type": "unstyled",
"depth": 0,
"inline_style_ranges": [
{
"offset": 0,
"length": 232,
"style": "color-rgba(0,0,0,0.65)"
},
{
"offset": 0,
"length": 232,
"style": "bgcolor-rgb(255,255,255)"
},
{
"offset": 0,
"length": 232,
"style": "fontsize-14"
},
{
"offset": 0,
"length": 232,
"style": "fontfamily--apple-system, system-ui, \"Segoe UI\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei\", \"Helvetica Neue\", Helvetica, Arial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol"
}
],
"entity_ranges": [],
"data": {
"text_align": "left"
}
},
{
"key": "1bkej",
"text": "Building connections doesn’t need to be difficult. With the right networking software, your attendees connect with the right people and your event. As well, they’ll pplaud you for helping them grow their networks and giving them amazing returns on their invested time.",
"type": "unstyled",
"depth": 0,
"inline_style_ranges": [
{
"offset": 0,
"length": 268,
"style": "color-rgba(0,0,0,0.65)"
},
{
"offset": 0,
"length": 268,
"style": "bgcolor-rgb(255,255,255)"
},
{
"offset": 0,
"length": 268,
"style": "fontsize-14"
},
{
"offset": 0,
"length": 268,
"style": "fontfamily--apple-system, system-ui, \"Segoe UI\", \"PingFang SC\", \"Hiragino Sans GB\", \"Microsoft YaHei\", \"Helvetica Neue\", Helvetica, Arial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol"
}
],
"entity_ranges": [],
"data": {
"text_align": "left"
}
},
{
"key": "655m",
"text": "",
"type": "unstyled",
"depth": 0,
"inline_style_ranges": [],
"entity_ranges": [],
"data": {}
},
{
"key": "d7b41",
"text": " ",
"type": "atomic",
"depth": 0,
"inline_style_ranges": [],
"entity_ranges": [
{
"offset": 0,
"length": 1,
"key": 1
}
],
"data": {}
},
{
"key": "e2kdg",
"text": "",
"type": "unstyled",
"depth": 0,
"inline_style_ranges": [],
"entity_ranges": [],
"data": {}
}
],
"entity_map": {
"0": {
"type": "LINK",
"mutability": "MUTABLE",
"data": {
"url": "https://www.youtube.com/embed/ICGxj817_Bw",
"title": "<span data-offset-key=\"fc9re-1-0\" style=\"box-sizing: border-box;\"><span data-text=\"true\" style=\"box-sizing: border-box;\">Brella Video</span></span>",
"target_option": "_blank",
"map": {
"size": 3,
"root": {
"owner_id": {},
"entries": []
},
"altered": false
}
}
},
"1": {
"type": "IMAGE",
"mutability": "MUTABLE",
"data": {
"src": "https://brella-dev.brella.io/uploads/content_image/image/555/a7d303b3a5e4b.png",
"height": "auto",
"width": "300px"
}
}
}
},
"uses-chat": true,
"app-sponsor": false,
"app-sponsor-image-url": null,
"cta-text": "Visit booth3asd asdasd",
"uses-analytics": true,
"lead-scanning-enabled": true,
"has-automatic-representatives-linking": true,
"created-at": "2020-03-24T14:11:51.110Z",
"updated-at": "2022-11-30T14:26:30.748Z",
"chat-channel-id": "sendbird_open_channel_12638_c5aaf208525ad5536d543639d485d3f5eed720e9"
},
"relationships": {
"category": {
"data": {
"id": "839",
"type": "sponsor-category"
}
},
"attendees": {
"data": [
{
"id": "61825",
"type": "attendee"
},
{
"id": "61828",
"type": "attendee"
},
{
"id": "61830",
"type": "attendee"
},
{
"id": "61834",
"type": "attendee"
},
{
"id": "61845",
"type": "attendee"
},
{
"id": "61846",
"type": "attendee"
},
{
"id": "61854",
"type": "attendee"
},
{
"id": "61855",
"type": "attendee"
},
{
"id": "61882",
"type": "attendee"
},
{
"id": "72144",
"type": "attendee"
},
{
"id": "73835",
"type": "attendee"
},
{
"id": "67701",
"type": "attendee"
},
{
"id": "62341",
"type": "attendee"
},
{
"id": "61823",
"type": "attendee"
},
{
"id": "62239",
"type": "attendee"
},
{
"id": "61829",
"type": "attendee"
},
{
"id": "61989",
"type": "attendee"
},
{
"id": "61901",
"type": "attendee"
},
{
"id": "63088",
"type": "attendee"
},
{
"id": "62080",
"type": "attendee"
},
{
"id": "62001",
"type": "attendee"
},
{
"id": "61900",
"type": "attendee"
},
{
"id": "62187",
"type": "attendee"
},
{
"id": "62349",
"type": "attendee"
},
{
"id": "63153",
"type": "attendee"
},
{
"id": "63103",
"type": "attendee"
},
{
"id": "63101",
"type": "attendee"
},
{
"id": "61827",
"type": "attendee"
},
{
"id": "64294",
"type": "attendee"
},
{
"id": "61826",
"type": "attendee"
},
{
"id": "107043",
"type": "attendee"
},
{
"id": "62264",
"type": "attendee"
},
{
"id": "62252",
"type": "attendee"
},
{
"id": "72077",
"type": "attendee"
},
{
"id": "91488",
"type": "attendee"
},
{
"id": "243236",
"type": "attendee"
},
{
"id": "243235",
"type": "attendee"
},
{
"id": "74228",
"type": "attendee"
},
{
"id": "67690",
"type": "attendee"
},
{
"id": "72074",
"type": "attendee"
},
{
"id": "95031",
"type": "attendee"
},
{
"id": "375509",
"type": "attendee"
},
{
"id": "284784",
"type": "attendee"
},
{
"id": "114023",
"type": "attendee"
},
{
"id": "66511",
"type": "attendee"
},
{
"id": "75708",
"type": "attendee"
},
{
"id": "104137",
"type": "attendee"
},
{
"id": "82977",
"type": "attendee"
},
{
"id": "62262",
"type": "attendee"
},
{
"id": "340229",
"type": "attendee"
},
{
"id": "304795",
"type": "attendee"
},
{
"id": "63649",
"type": "attendee"
},
{
"id": "129441",
"type": "attendee"
},
{
"id": "97443",
"type": "attendee"
},
{
"id": "137434",
"type": "attendee"
},
{
"id": "81604",
"type": "attendee"
},
{
"id": "63161",
"type": "attendee"
},
{
"id": "62348",
"type": "attendee"
}
]
},
"deck-media": {
"data": [
{
"id": "2194",
"type": "media"
},
{
"id": "28199",
"type": "media"
},
{
"id": "28197",
"type": "media"
},
{
"id": "28198",
"type": "media"
}
]
},
"attachments": {
"data": []
},
"tabs": {
"data": [
{
"id": "24085",
"type": "media"
},
{
"id": "24726",
"type": "media"
},
{
"id": "28196",
"type": "media"
}
]
},
"products":
{
"data":
[
{
"id": "13064",
"type": "product"
},
{
"id": "13063",
"type": "product"
}
]
}
}
},
"included": [
{
"id": "839",
"type": "sponsor-category",
"attributes": {
"level": "medium",
"name": "Silver",
"position": 995,
"sponsors-count": 6,
"allows-meet-at-booth": true
}
},
{
"id": "13064",
"type": "product",
"attributes": {
"title": "Product2",
"description": "Description2",
"url": "https://www.fabrikamstore.com/products/smartwatch-x500",
"image-url": null,
"position": 2
},
"relationships": {
"sponsor": {
"data": {
"id": "142054",
"type": "sponsor"
}
}
}
},
{
"id": "13063",
"type": "product",
"attributes": {
"title": "Product1",
"description": "Description1",
"url": "",
"image-url": null,
"position": 2
},
"relationships": {
"sponsor": {
"data": {
"id": "142054",
"type": "sponsor"
}
}
}
}
]
}REQUEST BODY
{
"sponsor": {
"category_id": "{{category_id}}",
"position": "{{position_id}}",
"uses_chat": true,
"uses_analytics": true,
"lead_scanning_enabled":true,
"name": "{{random_company_name}}",
"subtitle": "{{random_subtitle}},
"logo": "{{logo_url}}",
"cover_image": "{{cover_image_url}}",
"cta_text": "{{some_cta_text}}",
"facebook": "{{facebook_page_url}}",
"twitter": "{{twitter_url}}",
"linkedin": "{{linkedin_url}}",
"instagram": "{{instagram_url}}",
"website": "{{website_url}}",
"industry": "{{random_company}}",
"has_automatic_representatives_linking": true,
"representatives_linking_method": "company_domain_match",
"company_domains":["abc.com","xyz.io"],
"content":"{{rich_text_content}}",
"custom_fields_attributes": [
{
"key": "{{random_key}}",
"value": "{{random_value}}"
},
{
"key": "{{random_key}}",
"value": "{{random_value}}"
}
],
"products": [
{
"title": "{{random_product}}",
"description": "{{random_description}}",
"url": "{{random_url}}",
"image": "{{random_image}}"
},
{
"title": "{{random_product}}",
"description": "{{random_description}}",
"url": "{{random_url}}",
"image": "{{random_image}}"
}
],
"media": {
"deck_slides": [
{
"title": "{{random_title}}",
"url": "{{random_url}}",
"body_type": "image"
},
{
"title": "{{random_title}}",
"url": "{{random_url}}",
"body_type": "image"
},
{
"title": "{{random_title}}",
"url": "{{random_url}}",
"body_type": "iframe"
},
{
"title": "{{random_title}}",
"url": "{{random_url}}",
"body_type": "iframe"
}
],
"sidebar_tabs": [
{
"title": "{{random_tab}}",
"url": "{{random_url}}"
},
{
"title": "{{random_tab}}",
"url": "{{random_url}}"
}
]
}
}
}
Required attributes:
- category_id Number / see notes for more information
- name String / typically the company name
Notes:
01: The lead_scanning_enabled, uses_analytics, uses_chat and has_automatic_representatives_linking attributes are of the boolean type, and support the values true / false.
- lead_scanning_enabled: If true, allows any sponsor representatives / attendees linked to this sponsor company to use lead scanning to capture data by scanning QR codes. This data will be available to sponsor admins and reps in the Sponsor Admin Panel
- uses_analytics: If true, allows sponsor admins assigned to this sponsor company to see traffic analytics data (such as who visited their virtual booth and engaged with their content etc.)
- uses_chat: If true, enables a public booth chat for their virtual booth
- has_automatic_representatives_linking:
- If you'd like to automatically link sponsor representatives to this sponsor company, this needs to be set as TRUE along with the representatives_linking_method option.
- Leave false to manually select who is linked to this sponsor company.
- representatives_linking_methodsupports the following values:
- partial_company_name_match- links the representatives if the Sponsor Company Name matches most of the content. For example, if the Sponsor Company Name is 'ABC Ltd' and the user's company title is 'ABC' or 'ABC Ltd': Partial match will link. ✅
- exact_company_name_match- only links the representatives if the Sponsor Company Name matches exactly. This is case-sensitive.
- company_domain_match- links the representatives based on the Email Domains provided. For example: if Sponsor Company Name is 'ABC Ltd' and Email Domain is 'abc.com', all users with "abc.com" in their email addresses will be linked automatically.
- company_domain is an array which supports whatever domains you need to match sponsor reps by (eg: if you supply brella.io and google.ie as company domains — whenever anyone with a [email protected] or [email protected] email in their INVITE joins Brella, they will get assigned to that booth.)
02: The cover_image and logo attributes allow for automatic uploading of a booth cover image and sponsor logo from web-based sources. To use this, pass a URL leading to a valid image resource (JPG / JPEG / PNG etc.) as a string.
03: The values for the category_id attribute can be found in your event's Admin Panel (Sponsors > Categories). You can add as many categories as needed in the Admin Panel. Categories can't be created via the API just yet.
04: interest_categories should include a Matchmaking Category and the interests.
- If the interests don't exist in the matchmaking set-up, the API call will create these interests.
- If you make an API call where the interests array or any of those parameters is empty, it will delete them from the INVITE. It will NEVER DELETE interests from the event itself, since multiple attendees/ sponsors might be using these interests and identity data in the event.
05: product should be an array. Each object within the product sarray corresponds to a single sponsor product.
- The name, description, and url are mandatory.
06: custom_fields_attributes should be an array. Each object within the custom_fields_attributes array corresponds to a single custom field, which can be created manually from the Admin Panel:
- The Custom Field needs to be linked to the Sponsors.
- The key and value are mandatory.
- Currently, value needs to be a string.