Skip to main content
POST
Create a staff event registration

Authorizations

Authorization
string
header
required

Passport bearer token authentication for legacy admin sessions.

Path Parameters

eventId
integer
required

Record ID in the authenticated organization.

Example:

42

Body

application/json
purchaser
object
required

Purchaser and dynamic donor form fields; email may be omitted for staff entry.

idempotency_key
string
required

Retry key; required for public V2 and staff registrations. Reuse the same key for the same cart.

Maximum string length: 120
Example:

"registration-request-1"

tickets
object[] | null
sponsor_packages
object[] | null
auction_items
object[] | null
promo_code
string | null

Active event promo code; validity/redemption limits apply.

Maximum string length: 80
Example:

"WELCOME"

donation_amount
number | null

Optional donation add-on, suppressed when event settings disable it.

Required range: x >= 0
Example:

25

payment_method
string | null

Selected payment method; public checkout verifies payment separately. Check is available only when enabled.

Maximum string length: 80
Example:

"card"

gateway
string | null

Configured processor selection, such as stripe or paypal.

Maximum string length: 80
Example:

"stripe"

payment_intent_id
string | null

Payment reference where accepted; public checkout still verifies provider evidence.

Maximum string length: 255
Example:

"pi_example"

currency
string | null

Compatibility currency hint; the event determines the order currency.

Maximum string length: 8
Example:

"USD"

answers
object[] | null

Question answers scoped to this buyer, group or attendee.

Maximum array length: 100
conversion_intents

Monthly giving/child sponsorship interest, as a list of enabled keys or a map to true; disabled event asks are removed.

Follow-up interest.

Available options:
recurring_gift,
child_sponsorship
create_donor
boolean | null

Whether to create/link a donor when no existing purchaser record is supplied. Staff defaults false; public defaults true.

Example:

false

fees_covered_amount
number | null

Optional manually supplied fee coverage for this staff registration.

Required range: x >= 0
Example:

25

purchaser_donor_id
integer | null

Existing donor the staff actor can access; disables donor creation and fills missing profile fields from that record.

Example:

42

payment_disposition
enum<string> | null

Staff payment workflow; complimentary zeroes payable value and forbids donation/fee amounts.

Available options:
free,
saved_method,
different_card,
offline,
complimentary,
invoice,
null
Example:

"free"

transaction_id
string | null

Manual transaction reference.

Maximum string length: 255
Example:

"manual-001"

notes
string | null

Registration notes.

Example:

"Example"

send_confirmation
boolean | null

Queue confirmation if completed; defaults false.

Example:

false

registration_override_confirmed
boolean | null

Must be true to add staff registrations when RSVPs are closed.

Example:

false

Response

Create a staff event registration completed.

data
object