Skip to main content
POST
Add a trip participant

Authorizations

Authorization
string
header
required

Passport bearer token authentication for legacy admin sessions.

Path Parameters

tripId
integer
required

Trip ID belonging to the authenticated organization.

Body

application/json

Request fields accepted by this operation. Omitted optional properties retain the behavior described above.

email
string<email>
required

Validation: required|email.

Example:

"alex@example.org"

individual_goal
number | null

Validation: nullable|numeric|min:0|max:999999999.99.

Required range: 0 <= x <= 999999999.99
Example:

40

role
enum<string> | null

Validation: nullable|in:participant,leader.

Available options:
participant,
leader,
null
Example:

"participant"

is_minor
boolean | null

Validation: nullable|boolean.

Example:

false

guardian_name
string | null

Validation: nullable|string|max:255.

Maximum string length: 255
guardian_email
string<email> | null

Validation: nullable|email|max:255.

Maximum string length: 255
Example:

"alex@example.org"

guardian_phone
string | null

Validation: nullable|string|max:255.

Maximum string length: 255
guardian_relationship
string | null

Validation: nullable|string|max:255.

Maximum string length: 255
guardian_donor_id
integer | null

Guardian donor must belong to this organization.

Example:

1

permissions
object | null

Leader-only permission overrides; cleared for participant roles. Missing leader permissions use defaults; promote_leaders defaults false.

tags
string[] | null
Maximum string length: 100
first_name
string | null

Validation: nullable|string|max:255.

Maximum string length: 255
last_name
string | null

Validation: nullable|string|max:255.

Maximum string length: 255
phone
string | null

Validation: nullable|string|max:255.

Maximum string length: 255
is_public
boolean | null

Validation: nullable|boolean.

Example:

false

is_anonymous
boolean | null

Validation: nullable|boolean.

Example:

false

bio
string | null

Validation: nullable|string|max:2000.

Maximum string length: 2000
video_url
string<uri> | null

Validation: nullable|url.

Example:

"https://example.org/document.pdf"

send_invitation
boolean | null

Validation: nullable|boolean.

Example:

false

Response

Add a trip participant response.

Participant projections returned by roster, detail, create and update operations. Detailed fundraising/profile fields are present on reads; mutation responses contain the fields saved by that operation.

id
integer
donor_id
integer
entity_id
integer | null
name
string
email
string
phone
string | null
role
string
individual_goal
number
total_raised
number
progress_percent
number
status
string
is_public
boolean
is_anonymous
boolean
bio
string | null
video_url
string | null
is_minor
boolean
guardian_name
string | null
guardian_email
string | null
guardian_phone
string | null
guardian_relationship
string | null
guardian_donor_id
integer | null
background_check_status
string | null
background_check_provider_check_id
string | null
background_check_id
integer | null
background_check_report_url
string | null
background_check_updated_at
string<date-time> | null
background_check_expires_at
string<date> | null
background_check_adjudication
string | null
esignature_status
string | null
created_at
string<date-time>
permissions
object | null
effective_leader_permissions
object | null
tags
string[]
esignature_readiness
object
esignature_template_id
string | null
esignature_request_id
integer | null
esignature_provider_request_id
string | null
esignature_signed_document_url
string | null
esignature_signed_document_upload_id
integer | null
esignature_sent_at
string<date-time> | null
esignature_signed_at
string<date-time> | null