---
title: Update Invites
slug: update-invites
docTags: 
createdAt: 2023-04-12T08:32:15.000Z
---

:::hint{type="danger"}
**Important Note:&#x20;**&#x54;he Invite 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/{inviteId}",
  "name": "Update existing invite",
  "method": "PATCH",
  "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"
      },
      {
        "kind": "required",
        "name": "{inviteId}",
        "type": "Number",
        "children": [],
        "description": "The id of the invite you want to update"
      }
    ],
    "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\": \"Brella 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": "gnOqs-Qaa2Ryi-oB138yr",
        "language": "curl",
        "code": "curl --location -g --request PATCH 'https://api.brella.io/api/integration/organizations/{organizationId}/events/{eventId}/invites/{inviteId}' \\\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": "gnOqs-Qaa2Ryi-oB138yr"
  },
  "description": "Update an existing invite in an event",
  "currentNewParameter": {
    "label": "Path Parameter",
    "value": "pathParameters"
  },
  "hasTryItOut": false,
  "autoGeneratedAnchorSlug": "update-existing-invite",
  "legacyHash": "DzdJWf8RCI-QeqTp7mNRS"
}
```
:::

**REQUEST BODY**

:::BlockQuote
\{
&#x20; "event\_invite": \{
&#x20;   "external\_email": "\{\{random\_email}}",
&#x20;   "external\_id": "\{\{random\_ext\_uuid}}",
&#x20;   "external\_first\_name": "\{\{random\_first\_name}}",
&#x20;   "external\_last\_name": "\{\{random\_last\_name}}",
&#x20;   "external\_company": "\{\{random\_company}}",
&#x20;   "external\_title": "\{\{random\_title}}",
&#x20;   "external\_qr\_string": "\{\{random\_qr\_strings}}",
&#x20;   "ticket\_type\_list\_id": "\{\{ticket\_type\_list\_id}}",
&#x20;   "custom\_list\_ids":\["17441","18145"],
&#x20;   "persona": "\{\{random\_personna}}",
&#x20;   "industry": "\{\{random\_industry}}",
&#x20;   "function": "\{\{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": "\{\{random\_category}}",
&#x20;       "interests": \[
&#x20;         \{
&#x20;           "name": "\{\{random\_interest}}",
&#x20;           "intent\_ids": \[1,2,4,6]
&#x20;         },
&#x20;         \{
&#x20;           "name": "\{\{random\_interest}}",
&#x20;           "intent\_ids": \[1,4]
&#x20;         },
&#x20;         \{
&#x20;           "name": "\{\{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/vzZyQ4kXh5r5HpJko0gO5_image.png)

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

- This field allows passing QR Strings from a third party platform.
- Once this value is sent via the API, the Brella app would then show this External QR Code (instead of the typical Brella QR Strings), and Brella would be able to use that for lead scanning as well.

