curl --request POST \
--url 'https://app.floral.so/api/v1/workspaces/acme-nordic/events/42/participants' \
--header 'Authorization: Bearer $FLORAL_TOKEN' \
--header 'Idempotency-Key: createEventParticipantV1-20260816-001' \
--header 'Content-Type: application/json' \
--data '{
"companyName": "Acme Nordic",
"email": "ada@acme-nordic.example",
"name": "Ada Jensen",
"phone": "+45 20 11 22 33",
"responses": {
"session_track": "Workplace strategy"
}
}'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({name: 'Ada Jensen'})
};
fetch('https://app.floral.so/api/v1/workspaces/{workspaceSlug}/events/{eventId}/participants', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"participant": {
"attendanceState": "UNKNOWN",
"company": {
"id": 42,
"name": "Acme Nordic"
},
"companyName": "Acme Nordic",
"createdAt": "2026-09-02T10:20:00.000Z",
"email": "ada@acme-nordic.example",
"eventId": 42,
"id": "0f8b6c1e-3a52-4d6e-9b7a-2c4e5f6a7b8c",
"matchStatus": "MATCHED",
"name": "Ada Jensen",
"person": {
"id": 84,
"name": "Ada Jensen"
},
"phone": "+45 20 11 22 33",
"registrationState": "REGISTERED",
"representedCompany": {
"establishmentNumber": null,
"id": 42,
"name": "Acme Nordic"
},
"responses": {
"session_track": {
"answeredAt": "2026-09-02T10:20:00.000Z",
"value": "Workplace strategy"
}
},
"source": "API",
"updatedAt": "2026-09-02T10:20:00.000Z",
"version": "v1.eyJpZCI6IjBmOGI2YzFlLTNhNTItNGQ2ZS05YjdhLTJjNGU1ZjZhN2I4YyIsInJlc291cmNlIjoicGFydGljaXBhbnQiLCJ2ZXJzaW9uIjoiMiJ9",
"waitlistPosition": null
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Kaldet indeholder ugyldige værdier.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "En gyldig bearer-adgangsoplysning er påkrævet.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "Adgangsoplysningen giver ikke adgang til denne handling.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Ressourcen blev ikke fundet.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "CONFLICT",
"message": "Den ønskede ændring er i konflikt med ressourcens aktuelle tilstand.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "For mange kald. Prøv igen om lidt.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Der opstod en uventet fejl.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}Register an event participant
Register one participant. Honours the event’s registration switch and window, capacity, and waitlist. A full event without a waitlist, or closed registration, returns 409 CONFLICT.
curl --request POST \
--url 'https://app.floral.so/api/v1/workspaces/acme-nordic/events/42/participants' \
--header 'Authorization: Bearer $FLORAL_TOKEN' \
--header 'Idempotency-Key: createEventParticipantV1-20260816-001' \
--header 'Content-Type: application/json' \
--data '{
"companyName": "Acme Nordic",
"email": "ada@acme-nordic.example",
"name": "Ada Jensen",
"phone": "+45 20 11 22 33",
"responses": {
"session_track": "Workplace strategy"
}
}'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({name: 'Ada Jensen'})
};
fetch('https://app.floral.so/api/v1/workspaces/{workspaceSlug}/events/{eventId}/participants', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"participant": {
"attendanceState": "UNKNOWN",
"company": {
"id": 42,
"name": "Acme Nordic"
},
"companyName": "Acme Nordic",
"createdAt": "2026-09-02T10:20:00.000Z",
"email": "ada@acme-nordic.example",
"eventId": 42,
"id": "0f8b6c1e-3a52-4d6e-9b7a-2c4e5f6a7b8c",
"matchStatus": "MATCHED",
"name": "Ada Jensen",
"person": {
"id": 84,
"name": "Ada Jensen"
},
"phone": "+45 20 11 22 33",
"registrationState": "REGISTERED",
"representedCompany": {
"establishmentNumber": null,
"id": 42,
"name": "Acme Nordic"
},
"responses": {
"session_track": {
"answeredAt": "2026-09-02T10:20:00.000Z",
"value": "Workplace strategy"
}
},
"source": "API",
"updatedAt": "2026-09-02T10:20:00.000Z",
"version": "v1.eyJpZCI6IjBmOGI2YzFlLTNhNTItNGQ2ZS05YjdhLTJjNGU1ZjZhN2I4YyIsInJlc291cmNlIjoicGFydGljaXBhbnQiLCJ2ZXJzaW9uIjoiMiJ9",
"waitlistPosition": null
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Kaldet indeholder ugyldige værdier.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "En gyldig bearer-adgangsoplysning er påkrævet.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "Adgangsoplysningen giver ikke adgang til denne handling.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Ressourcen blev ikke fundet.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "CONFLICT",
"message": "Den ønskede ændring er i konflikt med ressourcens aktuelle tilstand.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "For mange kald. Prøv igen om lidt.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Der opstod en uventet fejl.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}Autorisationer
Godkend med en personlig Floral-adgangsnøgle, der er bundet til ét arbejdsområde.
Overskrifter
Valgfrit korrelations-id fra kalderen. Floral returnerer den anvendte værdi i X-Request-ID.
1 - 128Påkrævet idempotensnøgle. Identiske nye forsøg på samme kanoniske kald gentager oprindelig status, body, ETag, Location og request-id i 24 timer.
1 - 255Sti-parametre
Slug for det arbejdsområde, adgangsoplysningen er bundet til.
1 - 100^[a-z0-9]+(?:-[a-z0-9]+)*$Stable numeric event ID.
x >= 1Krop
Participant identity and answers keyed by registration field key. Answers are validated against the event's published registration form. Maximum 65536 bytes.
1 - 255255320^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$64Show child attributes
Show child attributes
Svar
Participant registered or placed on the waitlist
Show child attributes
Show child attributes
