---
title: Create invite
slug: create-invite
docTags: 
createdAt: 2023-04-12T08:32:15.000Z
---

:::hint{type="danger"}
**Important Note:&#x20;**&#x54;he Invites endpoint is changing on July 4th, 2026, with the release of Dynamic Registrant Lists. See [here](https://docs.google.com/document/d/13dPoTtGIv9AbzeCb44BKARwXeL4WR6ZRaN1qi_0wVs0/edit?usp=sharing) for details.
:::

:::ApiMethodV2
```json
{
  "tab": "examples",
  "url": "https://api.brella.io/api/integration/organizations/{organizationId}/events/{eventId}/invites/",
  "name": "Get new invite",
  "method": "POST",
  "request": {
    "pathParameters": [
      {
        "kind": "required",
        "name": "{organizationId}",
        "type": "Number",
        "children": [],
        "description": "The id of the Brella organization you are trying to retrieve data from"
      },
      {
        "kind": "required",
        "name": "{eventId}",
        "type": "Number",
        "children": [],
        "description": "The id of the Brella event you are trying to retrieve data from"
      }
    ],
    "queryParameters": [],
    "headerParameters": [
      {
        "kind": "required",
        "name": "Brella-API-Access-Token",
        "type": "String",
        "children": [],
        "description": "Your unique Brella API key"
      },
      {
        "kind": "required",
        "name": "Accept",
        "type": "string",
        "children": [],
        "description": "application/vnd.brella.v4+json"
      },
      {
        "kind": "required",
        "name": "Content-Type",
        "type": "string",
        "children": [],
        "description": "application/json"
      }
    ],
    "bodyDataParameters": [],
    "formDataParameters": []
  },
  "results": {
    "languages": [
      {
        "id": "PsoboMOJ9Uo00iBrqhmgp",
        "language": "200",
        "code": "[\n  {\n    \"data\": {\n      \"id\": \"12017635\",\n      \"type\": \"invite\",\n      \"attributes\": {\n        \"fill-token\": \"GPQA0M\",\n        \"external-email\": \"test+invites@brella.io\",\n        \"external-id\": \"123test456\",\n        \"external-first-name\": \"Test\",\n        \"external-last-name\": \"Invites\",\n        \"external-company\": \"Brella\",\n        \"external-title\": \"Test Event\",\n        \"qr-string\": \"brella_invite_id=12017635&brella_invite_token=GPQA0M\",\n        \"created-at\": \"2026-07-06T07:50:36.437Z\",\n        \"updated-at\": \"2026-07-06T08:01:05.285Z\",\n        \"ticket-type-list-name\": \"Sponsors (In-Person)\",\n        \"seat-count\": 1,\n        \"free-seat-count\": 1\n      },\n      \"relationships\": {\n        \"event\": {\n          \"data\": {\n            \"id\": \"8318\",\n            \"type\": \"event\"\n          }\n        },\n        \"ticket-type-list\": {\n          \"data\": {\n            \"id\": \"68637\",\n            \"type\": \"registrant-list\"\n          }\n        },\n        \"ticket-purchase\": {\n          \"data\": {\n            \"id\": \"53510cdf-e095-4896-8842-7fa4beef160b\",\n            \"type\": \"ticket-purchase\"\n          }\n        },\n        \"persona\": {\n          \"data\": {\n            \"id\": \"5056\",\n            \"type\": \"persona\"\n          }\n        },\n        \"function\": {\n          \"data\": {\n            \"id\": \"6891\",\n            \"type\": \"function\"\n          }\n        },\n        \"industry\": {\n          \"data\": {\n            \"id\": \"8945\",\n            \"type\": \"industry\"\n          }\n        },\n        \"seats\": {\n          \"data\": [\n            {\n              \"id\": \"12651467\",\n              \"type\": \"seat\"\n            }\n          ]\n        },\n        \"free-seats\": {\n          \"data\": [\n            {\n              \"id\": \"12651467\",\n              \"type\": \"seat\"\n            }\n          ]\n        },\n        \"question-responses\": {\n          \"data\": []\n        },\n        \"custom-fields\": {\n          \"data\": [\n            {\n              \"id\": \"3900419\",\n              \"type\": \"custom-field\"\n            },\n            {\n              \"id\": \"3900420\",\n              \"type\": \"custom-field\"\n            }\n          ]\n        },\n        \"selected-interests\": {\n          \"data\": [\n            {\n              \"id\": \"50666856\",\n              \"type\": \"selected-interest\"\n            },\n            {\n              \"id\": \"50666857\",\n              \"type\": \"selected-interest\"\n            },\n            {\n              \"id\": \"50666858\",\n              \"type\": \"selected-interest\"\n            },\n            {\n              \"id\": \"50666859\",\n              \"type\": \"selected-interest\"\n            },\n            {\n              \"id\": \"50666860\",\n              \"type\": \"selected-interest\"\n            },\n            {\n              \"id\": \"50666861\",\n              \"type\": \"selected-interest\"\n            },\n            {\n              \"id\": \"50666862\",\n              \"type\": \"selected-interest\"\n            }\n          ]\n        }\n      }\n    },\n    \"included\": [\n      {\n        \"id\": \"12651467\",\n        \"type\": \"seat\",\n        \"attributes\": {\n          \"token\": \"GPQA0M\"\n        },\n        \"relationships\": {\n          \"attendee\": {\n            \"data\": null\n          }\n        }\n      },\n      {\n        \"id\": \"68637\",\n        \"type\": \"registrant-list\",\n        \"attributes\": {\n          \"name\": \"Sponsors (In-Person)\",\n          \"description\": null,\n          \"display-name\": \"Sponsors (In-Person)\",\n          \"list-type\": \"ticket_type\",\n          \"attendance-type\": \"in_person\",\n          \"is-default\": false,\n          \"position\": null,\n          \"profile-badge\": null,\n          \"networking-enabled\": true,\n          \"lead-scanning-enabled\": true,\n          \"qr-code-visible\": true,\n          \"meeting-requests-outgoing\": null,\n          \"meeting-requests-incoming\": null,\n          \"max-outgoing-meeting-requests\": null,\n          \"max-accepted-meetings\": null,\n          \"show-invites-in-apps\": true,\n          \"show-invited-registrants\": true,\n          \"show-booking-system-join-url\": true,\n          \"created-at\": \"2026-07-04T04:17:21.421Z\",\n          \"updated-at\": \"2026-07-04T04:17:21.421Z\",\n          \"old-group-id\": 23377\n        }\n      },\n      {\n        \"id\": \"3900419\",\n        \"type\": \"custom-field\",\n        \"attributes\": {\n          \"key\": \"dinner\",\n          \"title\": \"Dinner\",\n          \"value\": \"Yes\",\n          \"values\": [\n            \"Yes\"\n          ]\n        }\n      },\n      {\n        \"id\": \"3900420\",\n        \"type\": \"custom-field\",\n        \"attributes\": {\n          \"key\": \"lunch\",\n          \"title\": \"Lunch\",\n          \"value\": null,\n          \"values\": []\n        }\n      },\n      {\n        \"id\": \"8318\",\n        \"type\": \"event\",\n        \"attributes\": {\n          \"id\": 8318,\n          \"name\": \"Amy - Networking Event\",\n          \"location\": \"\",\n          \"address\": \"\",\n          \"start-date\": \"2026-08-09\",\n          \"end-date\": \"2026-08-12\",\n          \"past\": false,\n          \"table-nickname\": \"table\",\n          \"infoarea-photo-url\": null,\n          \"cover-photo-url\": \"https://brella-assets.brella.io/uploads/event/cover_photo/8318/a4d3cb6f76783.jpg\",\n          \"logo-large-url\": \"https://brella-assets.brella.io/uploads/event/logo_large/8318/e9a22b36c3704.jpg\",\n          \"logo-small-url\": \"https://brella-assets.brella.io/uploads/event/logo_small/8318/a71f7a10dd4be.jpg\",\n          \"uses-interests\": true,\n          \"uses-timeslots\": true,\n          \"uses-tables\": false,\n          \"uses-sponsors\": true,\n          \"uses-speakers\": true,\n          \"event-type\": \"hybrid\",\n          \"uses-stream-link\": true,\n          \"uses-meeting-slots\": true,\n          \"uses-event-chat\": true,\n          \"uses-timeslot-chat\": false,\n          \"uses-wizard\": false,\n          \"uses-sponsor-booth-links\": false,\n          \"uses-ticketing\": false,\n          \"uses-checkout\": true,\n          \"uses-invoicing\": false,\n          \"uses-rsvp-overlapping\": true,\n          \"industry\": \"Artificial Intelligence\",\n          \"city\": \"Denver\",\n          \"country\": \"United States\",\n          \"region\": \"North America\",\n          \"created-at\": \"2024-08-06T09:30:14.514Z\",\n          \"updated-at\": \"2026-06-09T13:42:48.219Z\",\n          \"content\": null,\n          \"sponsors-name\": \"Partners\",\n          \"primary-color\": null,\n          \"secondary-color\": null,\n          \"intent-pair-ids\": null,\n          \"uses-reception-page\": false,\n          \"launches-at\": null,\n          \"start-time-utc\": \"2026-08-09T06:00:00.000Z\",\n          \"end-time-utc\": \"2026-08-13T05:59:59.999Z\",\n          \"chat-channel-id\": \"event-8318\",\n          \"slug\": \"amynetworkingevent\",\n          \"time-zone\": \"America/Boise\"\n        },\n        \"relationships\": {\n          \"tickets\": {\n            \"data\": []\n          },\n          \"registrant-lists\": {\n            \"data\": [\n              {\n                \"id\": \"68635\",\n                \"type\": \"registrant-list\"\n              },\n              {\n                \"id\": \"68634\",\n                \"type\": \"registrant-list\"\n              },\n              {\n                \"id\": \"68633\",\n                \"type\": \"registrant-list\"\n              },\n              {\n                \"id\": \"68638\",\n                \"type\": \"registrant-list\"\n              },\n              {\n                \"id\": \"68637\",\n                \"type\": \"registrant-list\"\n              },\n              {\n                \"id\": \"68636\",\n                \"type\": \"registrant-list\"\n              },\n              {\n                \"id\": \"68639\",\n                \"type\": \"registrant-list\"\n              }\n            ]\n          },\n          \"questions\": {\n            \"data\": []\n          }\n        }\n      },\n      {\n        \"id\": \"53510cdf-e095-4896-8842-7fa4beef160b\",\n        \"type\": \"ticket-purchase\",\n        \"attributes\": {\n          \"purchasers-email\": \"\",\n          \"first-name\": \"Test\",\n          \"last-name\": \"Invites\",\n          \"status\": \"completed\",\n          \"created-at\": \"2026-07-06T07:50:37.050Z\",\n          \"updated-at\": \"2026-07-06T07:50:37.199Z\",\n          \"purchase-completed-at\": \"2026-07-06T07:50:37.189Z\",\n          \"purchase-type\": \"checkout\",\n          \"purchasers-phone\": null,\n          \"tax-id-type\": null,\n          \"tax-id\": null,\n          \"address-line1\": null,\n          \"address-line2\": null,\n          \"address-postal-code\": null,\n          \"address-city\": null,\n          \"address-state\": null,\n          \"address-country-code\": null,\n          \"stripe-session-id\": null,\n          \"stripe-error\": null,\n          \"created-from\": \"admin_panel\"\n        },\n        \"relationships\": {\n          \"event\": {\n            \"data\": {\n              \"id\": \"8318\",\n              \"type\": \"event\"\n            }\n          }\n        }\n      },\n      {\n        \"id\": \"5056\",\n        \"type\": \"persona\",\n        \"attributes\": {\n          \"name\": \"Solution Provider\",\n          \"position\": 2\n        }\n      },\n      {\n        \"id\": \"6891\",\n        \"type\": \"function\",\n        \"attributes\": {\n          \"name\": \"Business Strategy / Planning\",\n          \"position\": 1\n        }\n      },\n      {\n        \"id\": \"8945\",\n        \"type\": \"industry\",\n        \"attributes\": {\n          \"name\": \"Technology and Software Development\",\n          \"position\": 1\n        }\n      },\n      {\n        \"id\": \"679919\",\n        \"type\": \"interest\",\n        \"attributes\": {\n          \"name\": \"Bookkeeping\",\n          \"position\": 16,\n          \"event-id\": 8318\n        },\n        \"relationships\": {\n          \"children\": {\n            \"data\": []\n          },\n          \"intent-pairs\": {\n            \"data\": [\n              {\n                \"id\": \"1\",\n                \"type\": \"intent-pair\"\n              },\n              {\n                \"id\": \"2\",\n                \"type\": \"intent-pair\"\n              },\n              {\n                \"id\": \"4\",\n                \"type\": \"intent-pair\"\n              },\n              {\n                \"id\": \"3\",\n                \"type\": \"intent-pair\"\n              }\n            ]\n          }\n        }\n      },\n      {\n        \"id\": \"1\",\n        \"type\": \"intent\",\n        \"attributes\": {\n          \"selection-label\": \"Network about this\",\n          \"match-label\": \"Networker\",\n          \"statistics-label\": \"Network\",\n          \"profile-label\": \"Networking about\",\n          \"position\": 1\n        },\n        \"relationships\": {\n          \"pair\": {\n            \"data\": {\n              \"id\": \"1\",\n              \"type\": \"intent\"\n            }\n          }\n        }\n      },\n      {\n        \"id\": \"50666856\",\n        \"type\": \"selected-interest\",\n        \"relationships\": {\n          \"selector\": {\n            \"data\": {\n              \"id\": \"12017635\",\n              \"type\": \"registrant\"\n            }\n          },\n          \"interest\": {\n            \"data\": {\n              \"id\": \"679919\",\n              \"type\": \"interest\"\n            }\n          },\n          \"intent\": {\n            \"data\": {\n              \"id\": \"1\",\n              \"type\": \"intent\"\n            }\n          }\n        }\n      },\n      {\n        \"id\": \"2\",\n        \"type\": \"intent\",\n        \"attributes\": {\n          \"selection-label\": \"Explore or buy\",\n          \"match-label\": \"Prospect\",\n          \"statistics-label\": \"Buy/Explore\",\n          \"profile-label\": \"Exploring getting or buying\",\n          \"position\": 2\n        },\n        \"relationships\": {\n          \"pair\": {\n            \"data\": {\n              \"id\": \"3\",\n              \"type\": \"intent\"\n            }\n          }\n        }\n      },\n      {\n        \"id\": \"50666857\",\n        \"type\": \"selected-interest\",\n        \"relationships\": {\n          \"selector\": {\n            \"data\": {\n              \"id\": \"12017635\",\n              \"type\": \"registrant\"\n            }\n          },\n          \"interest\": {\n            \"data\": {\n              \"id\": \"679919\",\n              \"type\": \"interest\"\n            }\n          },\n          \"intent\": {\n            \"data\": {\n              \"id\": \"2\",\n              \"type\": \"intent\"\n            }\n          }\n        }\n      },\n      {\n        \"id\": \"4\",\n        \"type\": \"intent\",\n        \"attributes\": {\n          \"selection-label\": \"Find a job\",\n          \"match-label\": \"Job seeker\",\n          \"statistics-label\": \"Get a job\",\n          \"profile-label\": \"Seeking a job in\",\n          \"position\": 4\n        },\n        \"relationships\": {\n          \"pair\": {\n            \"data\": {\n              \"id\": \"5\",\n              \"type\": \"intent\"\n            }\n          }\n        }\n      },\n      {\n        \"id\": \"50666858\",\n        \"type\": \"selected-interest\",\n        \"relationships\": {\n          \"selector\": {\n            \"data\": {\n              \"id\": \"12017635\",\n              \"type\": \"registrant\"\n            }\n          },\n          \"interest\": {\n            \"data\": {\n              \"id\": \"679919\",\n              \"type\": \"interest\"\n            }\n          },\n          \"intent\": {\n            \"data\": {\n              \"id\": \"4\",\n              \"type\": \"intent\"\n            }\n          }\n        }\n      },\n      {\n        \"id\": \"6\",\n        \"type\": \"intent\",\n        \"attributes\": {\n          \"selection-label\": \"Get investment\",\n          \"match-label\": \"Investee\",\n          \"statistics-label\": \"Get Investment\",\n          \"profile-label\": \"Seeking investment for\",\n          \"position\": 7\n        },\n        \"relationships\": {\n          \"pair\": {\n            \"data\": {\n              \"id\": \"7\",\n              \"type\": \"intent\"\n            }\n          }\n        }\n      },\n      {\n        \"id\": \"50666859\",\n        \"type\": \"selected-interest\",\n        \"relationships\": {\n          \"selector\": {\n            \"data\": {\n              \"id\": \"12017635\",\n              \"type\": \"registrant\"\n            }\n          },\n          \"interest\": {\n            \"data\": {\n              \"id\": \"679919\",\n              \"type\": \"interest\"\n            }\n          },\n          \"intent\": {\n            \"data\": {\n              \"id\": \"6\",\n              \"type\": \"intent\"\n            }\n          }\n        }\n      },\n      {\n        \"id\": \"679924\",\n        \"type\": \"interest\",\n        \"attributes\": {\n          \"name\": \"Policy Underwriting\",\n          \"position\": 17,\n          \"event-id\": 8318\n        },\n        \"relationships\": {\n          \"children\": {\n            \"data\": []\n          },\n          \"intent-pairs\": {\n            \"data\": [\n              {\n                \"id\": \"1\",\n                \"type\": \"intent-pair\"\n              },\n              {\n                \"id\": \"3\",\n                \"type\": \"intent-pair\"\n              }\n            ]\n          }\n        }\n      },\n      {\n        \"id\": \"50666860\",\n        \"type\": \"selected-interest\",\n        \"relationships\": {\n          \"selector\": {\n            \"data\": {\n              \"id\": \"12017635\",\n              \"type\": \"registrant\"\n            }\n          },\n          \"interest\": {\n            \"data\": {\n              \"id\": \"679924\",\n              \"type\": \"interest\"\n            }\n          },\n          \"intent\": {\n            \"data\": {\n              \"id\": \"1\",\n              \"type\": \"intent\"\n            }\n          }\n        }\n      },\n      {\n        \"id\": \"50666861\",\n        \"type\": \"selected-interest\",\n        \"relationships\": {\n          \"selector\": {\n            \"data\": {\n              \"id\": \"12017635\",\n              \"type\": \"registrant\"\n            }\n          },\n          \"interest\": {\n            \"data\": {\n              \"id\": \"679924\",\n              \"type\": \"interest\"\n            }\n          },\n          \"intent\": {\n            \"data\": {\n              \"id\": \"4\",\n              \"type\": \"intent\"\n            }\n          }\n        }\n      },\n      {\n        \"id\": \"679928\",\n        \"type\": \"interest\",\n        \"attributes\": {\n          \"name\": \"Tax Accounting\",\n          \"position\": 18,\n          \"event-id\": 8318\n        },\n        \"relationships\": {\n          \"children\": {\n            \"data\": []\n          },\n          \"intent-pairs\": {\n            \"data\": [\n              {\n                \"id\": \"1\",\n                \"type\": \"intent-pair\"\n              }\n            ]\n          }\n        }\n      },\n      {\n        \"id\": \"50666862\",\n        \"type\": \"selected-interest\",\n        \"relationships\": {\n          \"selector\": {\n            \"data\": {\n              \"id\": \"12017635\",\n              \"type\": \"registrant\"\n            }\n          },\n          \"interest\": {\n            \"data\": {\n              \"id\": \"679928\",\n              \"type\": \"interest\"\n            }\n          },\n          \"intent\": {\n            \"data\": {\n              \"id\": \"1\",\n              \"type\": \"intent\"\n            }\n          }\n        }\n      }\n    ]\n  }\n]",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "PsoboMOJ9Uo00iBrqhmgp"
  },
  "examples": {
    "languages": [
      {
        "id": "-oveBwgMcziTmEBch0MKn",
        "language": "curl",
        "code": "curl --location -g --request POST 'https://api.brella.io/api/integration/organizations/{organizationId}/events/{eventId}/invites' \\\n--header 'Brella-API-Access-Token: String' \\\n--header 'Accept: application/vnd.brella.v4+json' \\\n--header 'Content-Type: application/json'\\\n--data '{\n  \"event_invite\": {\n    \"external_email\": \"{{random_email}}\",\n    \"external_id\": \"{{random_ext_uuid}}\",\n    \"external_first_name\": \"{{random_first_name}}\",\n    \"external_last_name\": \"{{random_last_name}}\",\n    \"external_company\": \"{{random_company}}\",\n    \"external_title\": \"{{random_title}}\",\n    \"external_qr_string\": \"{{random_qr_strings}}\",\n    \"ticket_type_list_id\": \"{{ticket_type_list_id}}\",\n    \"custom_list_ids\":[\"17441\",\"18145\"],\n    \"persona\": \"Researcher\",\n    \"industry\": \"Health and Wellness\",\n    \"function\": \"Development / Engineering\",\n     \"custom_fields_attributes\": [\n        {\n           \"key\": \"{{random_key_1}}\", \n           \"value\": \"{{random_value_1}}\"\n        },\n        {\n           \"key\": \"{{random_key_2}}\", \n           \"value\": \"{{ random_value_2}}\"\n        }\n    ],\n    \"interest_categories\": [\n      {\n        \"name\": \"a MM Category\",\n        \"interests\": [\n          {\n            \"name\": \"My first interest\",\n            \"intent_ids\": [1,2,4,6]\n          },\n          {\n            \"name\": \"My second interest\",\n            \"intent_ids\": [1,4]\n          },\n          {\n            \"name\": \"Oooh another Interest\"\n          }\n        ]\n      }\n    ]\n  },\n  \"import_interest_selections\": true,\n  \"import_identity_selections\": true\n}'",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "-oveBwgMcziTmEBch0MKn"
  },
  "description": "Create a new invite in an event",
  "currentNewParameter": {
    "label": "Body Parameter",
    "value": "bodyDataParameters"
  },
  "hasTryItOut": false,
  "autoGeneratedAnchorSlug": "get-new-invite",
  "legacyHash": "GVk1RuRk7dJUk_oA_kdbt"
}
```
:::

**REQUEST BODY**

:::BlockQuote
\{
&#x20; "event\_invite": \{
&#x20;   "external\_email": "&#x7B;&#x7B;random\_email}}",
&#x20;   "external\_id": "&#x7B;&#x7B;random\_ext\_uuid}}",
&#x20;   "external\_first\_name": "&#x7B;&#x7B;random\_first\_name}}",
&#x20;   "external\_last\_name": "&#x7B;&#x7B;random\_last\_name}}",
&#x20;   "external\_company": "&#x7B;&#x7B;random\_company}}",
&#x20;   "external\_title": "&#x7B;&#x7B;random\_title}}",
&#x20;   "external\_qr\_string": "&#x7B;&#x7B;random\_qr\_strings}}",
&#x20;   "ticket\_type\_list\_id": "&#x7B;&#x7B;ticket\_type\_list\_id}}",
&#x20;   "custom\_list\_ids":\["17441","18145"],
&#x20;   "persona": "&#x7B;&#x7B;random\_personna}}",
&#x20;   "industry": "&#x7B;&#x7B;random\_industry}}",
&#x20;   "function": "&#x7B;&#x7B;random\_function}}",
&#x20;   "custom\_fields\_attributes": \[
&#x20;       \{
&#x20;          "key": "\{\{random\_key\_1}}",&#x20;
&#x20;          "value": "\{\{random\_value\_1}}"
&#x20;       },
&#x20;       \{
&#x20;          "key": "\{\{random\_key\_2}}",&#x20;
&#x20;          "value": "\{\{ random\_value\_2}}"
&#x20;       }
&#x20;   ],
&#x20;   "interest\_categories": \[
&#x20;     \{
&#x20;       "name": "&#x7B;&#x7B;random\_category}}",
&#x20;       "interests": \[
&#x20;         \{
&#x20;           "name": "&#x7B;&#x7B;random\_interest}}",
&#x20;           "intent\_ids": \[1,2,4,6]
&#x20;         },
&#x20;         \{
&#x20;           "name": "&#x7B;&#x7B;random\_interest}}",
&#x20;           "intent\_ids": \[1,4]
&#x20;         },
&#x20;         \{
&#x20;           "name": "&#x7B;&#x7B;random\_interest}}"
&#x20;         }
&#x20;       ]
&#x20;     }
&#x20;   ]
&#x20; },
&#x20; "import\_interest\_selections": true,
&#x20; "import\_identity\_selections": true
&#x20; }
}
:::

**Required attributes:**

- `external_email` (String / supports accents and special characters)
- `seats` (Number / see notes for more information)
- `import_interest_selections` These attributes by default are FALSE. However, if these are not set to TRUE, any interests/ intents and identity data (personas, function, industry) won't get updated or created.
- `import_identity_selections` These attributes by default are FALSE. However, if these are not set to TRUE, any interests/ intents and identity data (personas, function, industry) won't get updated or created.
-

**Notes:**

**01:** The `ticket_type_list_id` (legacy version:`attendee_group_id`) attribute is used to map different ticket types to Brella's Ticket Types List, which allows you to control networking privileges, session access privileges and more. You can create as many ticket type lists as needed in the Admin Panel of your event (Event > People > Lists > New List >Ticket Type). The `ticket_type_list_id` values for the created lists are visible in the Admin Panel or via `/registrant-list` endpoint. If a value is not specified in the request, the invite will be added to a default All Registrants list in Brella.&#x20;

- One registrant can only belong to one ticket type list.
- In case the registrant needs to belong to multiple lists, you can utilize Custom Lists.

**02:** The `custom_list_ids` attribute is used to assign registrants to Brella's Custom List, which allows you to control networking privileges, session access privileges, and more. You can create as many custom lists as needed in the Admin Panel of your event (Event > People > Lists > New List > Custom). The custom\_list\_ids values for the created lists are visible in the Admin Panel or via the`/registrant-list` endpoint.&#x20;

- One registrant can belong to multiple custom lists.
- More details [here](https://help-organizers.brella.io/en/articles/721786-registrants-lists-overview) from our Help Center.

**03**: Matchmaking and Identities Prefilling.

- There are two attributes, which need to be set to "true":
  - `import_interest_selections`
  - `import_identity_selections`
- If the interests/ identities don't exist in the matchmaking set-up, the API call will create these interests and identities.
- 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 or identities from the event itself, since multiple attendees might be using these interests and identity data in the event.
- If the parameters `"interest_categories"`, `"persona"`, `"industry"` and `"function"`are NOT present in the request (i.e. you don't have these attributes at all), they won't be updated.
- To specify intents for a specific MM interest, you need to use "intent IDs" that correspond to the following intents:
  - 1 = Networking
  - 2,3 = Trading
    - 2 = Exploring Getting or Buying
    - 3 = Offer or Sell this
  - 4,5 = Recruitment
    - 4 = Get a job in this
    - 5 = Offer a job in this
  - 6,7 = Investment
    - 6 = Get investment in this
    - 7 = Invest in this
  - 8,9 = Mentoring
    - 8 = Find a mentor
    - 9 = Be a mentor
- If you want to include both intents within a pair, you need to add both "`intent_ids`" in the array.&#x20;
- If you don't specify the "`intent_ids`" array inside the interest object, all intents will get selected by default.

**04**: Custom Fields Attributes

- In order to pass this value through the API, you first need to create the custom field under Custom Content -> Custom Fields&#x20;
- The Field Name can be any value that is easy for you to recognize.
- The Field Key will be the parameter in your API body request.&#x20;
- The Custom Fields need to be linked to Registrants.
- More instructions here: [https://help-organizers.brella.io/en/articles/323077-creating-a-custom-field](https://help-organizers.brella.io/en/articles/323077-creating-a-custom-field)

![](https://api.archbee.com/api/optimize/11QWKB68xWhk4CIcqFyE2/YLiXMVfqHWKvUAZOtfDf6_image.png)

**05**: External QR Strings `external_qr_string`

- This field allows you to pass a custom QR code string from a third-party platform to Brella.
- Once this value is sent via the API, the Brella app will display this external QR code instead of the default Brella QR code. Brella will also use this external QR code for lead scanning as well.
- This feature is especially helpful if your ticketing or onsite providers (e.g: Swoogo, Bizzabo, etc.) already generate a QR code.&#x20;
  - You can pass that same QR code to Brella using the `external_qr_string` field.&#x20;
  - This ensures that the same QR code is used across all platforms, such as check-ins, badge printing, lead retrieval, etc.

