Skip to main content
POST
Create a trip

Authorizations

Authorization
string
header
required

Passport bearer token authentication for legacy admin sessions.

Body

application/json

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

name
string
required

Validation: required|string|max:255.

Maximum string length: 255
Example:

"Follow up with trip participants"

fundraising_goal
number
required

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

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

40

status
enum<string>
required

Validation: required|in:draft,active,completed,archived,cancelled.

Available options:
draft,
active,
completed,
archived,
cancelled
Example:

"draft"

slug
string | null

Unique within the organization; generated from name when omitted on create.

Maximum string length: 255
Pattern: ^[a-z0-9-]+$
Example:

"uganda-service-trip"

description
string | null

Validation: nullable|string|max:50000.

Maximum string length: 50000
Example:

"Please review the updated trip details."

destination
string | null

Validation: nullable|string|max:255.

Maximum string length: 255
Example:

"Kampala, Uganda"

start_date
string<date-time> | null

Validation: nullable|date.

Example:

"2026-10-20T09:00:00Z"

end_date
string<date-time> | null

Trip end date; must be on or after start_date.

Example:

"2026-10-20T09:00:00Z"

cover_image_id
integer | null

Validation: nullable|integer.

Example:

1

settings
object | null

Trip-specific settings merged with saved settings on update. Binding IDs must belong to this organization. background_check_validity_months is validated but stripped before storage; Checkr owns validity. sample_seed is preserved and cannot be supplied by callers.

Response

Create a trip response.

id
integer
name
string
slug
string
status
string
fundraising_goal
number
total_raised
number
progress_percent
number
participant_count
integer
is_sample_trip
boolean
sample_seed_version
integer | null
created_at
string<date-time>
updated_at
string<date-time>
destination
string | null
start_date
string<date> | null
end_date
string<date> | null