Create Registrant
gotowebinar.create_registrant
ActionChat & messagingconnection required
Calls the GoToWebinar API with the connection's credentials.
Register someone for a webinar and return the personal join URL GoTo issues.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- OAuth 2.0
- Providers
- GoToWebinar
- Secret shape
- {"client_id": "…", "client_secret": "…", "refresh_token": "…"}
- Config it needs
- organizer_key, account_key
- Resolved by
- config.connection_id, else node.connection_id
Configuration
8 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
webinar_key The key of the webinar to act on, as returned by a list call. | string | Yes | — | — | 9876543210987654321 |
first_name The registrant's first name; required unless it is in the JSON object. | string | No | — | — | — |
last_name The registrant's last name; required unless it is in the JSON object. | string | No | — | — | — |
email The registrant's email address; required unless it is in the JSON object. | string | No | — | email format | — |
registrant The whole registrant as GoTo's own JSON — use this for the optional fields (organization, jobTitle, phone, source) and for 'responses', the answers to the webinar's custom questions. | object | No | — | — | {"email":"ada@example.com","firstName":"Ada","lastName":"Lovelace","organization":"Analytical Engines","source":"Newsletter 123"} |
resend_confirmation Resend GoTo's confirmation email when this person is already registered. | boolean | No | false | — | — |
basic_fields_only Register with first name, last name and email only, ignoring the webinar's other registration fields. | boolean | No | false | — | — |
organizer_key Overrides the connection's organizer key for this call. | string | No | — | — | — |
- At least one of registrant, email must be set.
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"basic_fields_only": false,
"registrant": {
"email": "ada@example.com",
"firstName": "Ada",
"lastName": "Lovelace",
"organization": "Analytical Engines",
"source": "Newsletter 123"
},
"resend_confirmation": false,
"webinar_key": "9876543210987654321"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
created True when this call registered the person. | boolean | — |
already_registered True when GoTo answered 409 because that email was already registered. | boolean | — |
registrant_key The key GoTo assigned the registration. | string | — |
join_url The personal URL this registrant joins with. | string | — |
webinar_key The webinar the person was registered for. | string | — |
detail GoTo's message when the registration already existed. | string | — |
{
"already_registered": false,
"created": false,
"detail": "",
"join_url": "",
"registrant_key": "",
"webinar_key": ""
}Notes
- A repeat registration is reported as already_registered rather than failing the step, so replaying a list of leads is safe.
- Custom questions the organizer marked required must be answered through the 'responses' array — read them with Get Registration Fields first.
See Create Registrant run in a workflow.
In a technical demo we add the GoToWebinar connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.