swarmtix_speakers_create
Adds a speaker, with an optional photo, to an online event
swarmtix_speakers_create
Creates a speaker on an online event and returns it. The speaker belongs to this event only.
When you would reach for it
- Adding the people who will give the talks.
- Clearing the
NoSpeakersblocker thatswarmtix_event_readinessreports.
Scope
events:write
The connection's user must be allowed to edit the event, and the event must be an online event.
It is not idempotent: each call creates a new speaker, even when the name is the same.
This tool can fetch an image from a URL you give it, so it is the one speaker tool marked openWorldHint: true, like swarmtix_event_images_set.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
event | string | Yes | - | The event's id (a GUID) or its URL slug. |
firstName | string | Yes | - | The speaker's first name. Up to 255 characters. |
email | string | Yes | - | The speaker's email address. It is not shown on the event page and is never returned by any tool. |
lastName | string | No | empty | Up to 255 characters. |
company | string | No | empty | Up to 255 characters. |
jobTitle | string | No | empty | Up to 255 characters. |
bio | string | No | empty | The biography. Basic HTML is kept. Up to 20,000 characters. |
photo | string | No | none | A public https URL on port 443, a data:image/...;base64, URI or plain base64. PNG, JPEG, WebP and GIF, at most 10 MB. A resized WebP copy is stored. |
Example call
{
"name": "swarmtix_speakers_create",
"arguments": {
"event": "spring-summit-online",
"firstName": "Ana",
"lastName": "Petrova",
"email": "[email protected]",
"company": "Acme",
"jobTitle": "Engineer"
}
}What comes back
The new speaker: id, firstName, lastName, company, jobTitle and photo. The email is not returned.
What happens when you call it
- The event is resolved through the edit gate and must be an online event.
- Text is cleaned and the email is checked.
- A photo is fetched or decoded and prepared with the same image pipeline as
swarmtix_event_images_set, then stored. A bad photo stops the call before anything is written. - The speaker gets a unique URL slug of at most 30 characters and is linked to the event.
Troubleshooting
"Event not found, or this connection does not have access to it."
The event does not exist, it belongs to another organisation, or this organizer may read it but not edit it.
"This event is not an online event. Talks, speakers, categories and hosts belong to online events only. Nothing was changed."
The event is a physical event. These tools only work on events created with kind: "online".
A photo error
The photo could not be fetched or decoded. An https URL is fetched through a guarded client (port 443 only, no redirects, 10 seconds, 10 MB), and every fetch failure gives the same sentence on purpose.
Use cases
- Building a lineup from a list of names