/events/{event_code}/registrations

post

https://api.brazen.com/core/v1/events/{event_code}/registrations

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

event_code

string

required

A hashid that identifies the event. (format: matching ^[a-zA-Z0-9]$, at least 5 characters)

Query Params

send_reg_conf_email

boolean

Defaults to true

Set this parameter to false if you do not want the standard Brazen registration confirmation sent to the registrant.

Body Params

Event registration to create

int64

The unique identifier of the registration. Not required for new registrations.

first_name

string

The registrant's given name. This property is returned from GET requests. It's only required and honored during a POST if the user does not already exist in the system. It is always ignored if received in a PUT.

last_name

string

The registrant's surname. This property is returned from GET requests. It's only required and honored during a POST if the user does not already exist in the system. It is always ignored if received in a PUT.

string

required

The registrant's email address. When posting a new registration, if the email does not match a currently existing user within the system, a new user will be created and both first and last name must also be provided.

user_id

int64

Brazen's identifier for the user to whom the registration belongs. This property only has a value on GET requests and is ignored in POST or PUT requests.

external_id

string

The identity provider's identifier for the user to whom the registration belongs. This property only has a value when the user has an external identity (they have used any Single Sign-On option to log in). This property is ignored in POST and PUT requests.

verified_user

boolean

Indicates the user has completed email verification for their Brazen account. Single Sign-On users are considered verified automatically after their initial sign-in.

completed

boolean

Indicates the user has completed their event registration.

registered_on

date-time

An ISO-8601 UTC timestamp for when the registration was submitted. Defaults to date and time registration received at Brazen (format: yyyy-MM-ddTHH:mm:ssZ). This property only has a value on GET requests and is ignored in POST or PUT requests.

last_updated

date-time

An ISO-8601 UTC timestamp for when the registration was last updated (format: yyyy-MM-ddTHH:mm:ssZ). This property only has a value on GET requests and is ignored in POST or PUT requests.

event_code

string

required

The hashid that identifies the event.

peer_group

string

The peer group to register the user for. This property is ignored in PUT requests.

event_roles

array of strings

The list of user roles for event staff. Possible values include: representative, group-video-host, webinar-host, webinar-presenter.

event_roles

attended

boolean

Indicates the user attended the event while it was live; value is always null until event is live. This property only has a value on GET requests and is ignored in POST or PUT requests.

data

string

required

Contains all the input that was submitted by the registrant when they registered for the event (or when they edited their registration) in the format "{field label}={user input}[& ...]".

The field labels and user input values are URL encoded; the equal sign separating labels from values and the ampersands separating label-value pairs are not encoded.

File upload field types, including Resume and Profile Picture, are available through the /files endpoint.

Representatives in open house and expo type events have user profiles, which span multiple events, in place of individual event registrations. These profiles can be created and updated through our API just like registrations using the following fields:

Profile Pic (see /files endpoint)
Job Title
Summary
City
State
Country
LinkedIn Profile
Mobile Phone

Headers

Authorization

string

required

A bearer token retrieved using your client_id and client_secret.

Responses

400

User with the provided email could not be found, and there was insufficient information to be able to create a new user. (email address, first name, and last name are required to create user)

401

The request contained an invalid token or none at all.

403

Token is not permitted to access this resource.

404

Resource requested could not be found.

409

The person is already registered for this event; switch to PUT to update.

201The new registration was successfully created.