Integration API quickstart
Updating existing records using external_id
1min
many entities in brella (eg invites, speakers, sponsors, timeslots etc ) support a field called external id this field is not visible in the admin panel, and is only accessible via the api or csv imports / exports the field is of the string data type and supports almost any data the most common use case for this field is to write a 3rd party app's unique identifier to brella when creating an entity this allows for a common unique attribute that can be used when updating, finding or deleting the created entity for example, when creating an invite from a 3rd party crm (eg hubspot), you would write the hubspot contact id (generated by hubspot) to the external id field in the brella invite then, if you need to update the invite later (for example, if the hubspot contact changes their email, or drops out of the event), you can find the invite by it's external id, using the "find invite by external id" endpoint, get the unique brella uuid ("id") from the response, and update that invite record using the "update invite" endpoint — which accepts the brella uuid in the url