Public

Request to join a public trip

Creates a requested trip participant from the public trip page. The controller only accepts active trips with request_to_join_enabled set in trip settings, then delegates validation and participant creation to TripParticipantService::createJoinRequest. The service requires email, may require standardized donor fields or public signup fields configured for the trip donor form, creates or updates a donor, creates a fundraising entity, and stores the participant with requested status.

POST

frontend

public

trips

{clientSlugOrId}

{tripSlug}

request-to-join

Request to join a public trip

curl --request POST \
  --url https://api.gratona.com/v1/frontend/public/trips/{clientSlugOrId}/{tripSlug}/request-to-join \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "participant@example.org",
  "type": "INDIVIDUAL",
  "organization_name": "Acme Foundation",
  "policy_revision": "current-form-revision",
  "first_name": "Sam",
  "last_name": "Taylor",
  "phone": "+15551234567",
  "country_code": "US",
  "subdivision_code": "US-CA",
  "individual_goal": 2500,
  "is_public": true,
  "is_anonymous": false,
  "bio": "I am raising funds for this service trip.",
  "video_url": "https://www.youtube.com/watch?v=abc123",
  "social_links": {},
  "is_minor": false,
  "guardian_name": "Jordan Taylor",
  "guardian_email": "guardian@example.org",
  "guardian_phone": "+15557654321",
  "guardian_relationship": "Parent"
}
'

import requests

url = "https://api.gratona.com/v1/frontend/public/trips/{clientSlugOrId}/{tripSlug}/request-to-join"

payload = {
    "email": "participant@example.org",
    "type": "INDIVIDUAL",
    "organization_name": "Acme Foundation",
    "policy_revision": "current-form-revision",
    "first_name": "Sam",
    "last_name": "Taylor",
    "phone": "+15551234567",
    "country_code": "US",
    "subdivision_code": "US-CA",
    "individual_goal": 2500,
    "is_public": True,
    "is_anonymous": False,
    "bio": "I am raising funds for this service trip.",
    "video_url": "https://www.youtube.com/watch?v=abc123",
    "social_links": {},
    "is_minor": False,
    "guardian_name": "Jordan Taylor",
    "guardian_email": "guardian@example.org",
    "guardian_phone": "+15557654321",
    "guardian_relationship": "Parent"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    email: 'participant@example.org',
    type: 'INDIVIDUAL',
    organization_name: 'Acme Foundation',
    policy_revision: 'current-form-revision',
    first_name: 'Sam',
    last_name: 'Taylor',
    phone: '+15551234567',
    country_code: 'US',
    subdivision_code: 'US-CA',
    individual_goal: 2500,
    is_public: true,
    is_anonymous: false,
    bio: 'I am raising funds for this service trip.',
    video_url: 'https://www.youtube.com/watch?v=abc123',
    social_links: {},
    is_minor: false,
    guardian_name: 'Jordan Taylor',
    guardian_email: 'guardian@example.org',
    guardian_phone: '+15557654321',
    guardian_relationship: 'Parent'
  })
};

fetch('https://api.gratona.com/v1/frontend/public/trips/{clientSlugOrId}/{tripSlug}/request-to-join', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gratona.com/v1/frontend/public/trips/{clientSlugOrId}/{tripSlug}/request-to-join",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => 'participant@example.org',
    'type' => 'INDIVIDUAL',
    'organization_name' => 'Acme Foundation',
    'policy_revision' => 'current-form-revision',
    'first_name' => 'Sam',
    'last_name' => 'Taylor',
    'phone' => '+15551234567',
    'country_code' => 'US',
    'subdivision_code' => 'US-CA',
    'individual_goal' => 2500,
    'is_public' => true,
    'is_anonymous' => false,
    'bio' => 'I am raising funds for this service trip.',
    'video_url' => 'https://www.youtube.com/watch?v=abc123',
    'social_links' => [
        
    ],
    'is_minor' => false,
    'guardian_name' => 'Jordan Taylor',
    'guardian_email' => 'guardian@example.org',
    'guardian_phone' => '+15557654321',
    'guardian_relationship' => 'Parent'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gratona.com/v1/frontend/public/trips/{clientSlugOrId}/{tripSlug}/request-to-join"

	payload := strings.NewReader("{\n  \"email\": \"participant@example.org\",\n  \"type\": \"INDIVIDUAL\",\n  \"organization_name\": \"Acme Foundation\",\n  \"policy_revision\": \"current-form-revision\",\n  \"first_name\": \"Sam\",\n  \"last_name\": \"Taylor\",\n  \"phone\": \"+15551234567\",\n  \"country_code\": \"US\",\n  \"subdivision_code\": \"US-CA\",\n  \"individual_goal\": 2500,\n  \"is_public\": true,\n  \"is_anonymous\": false,\n  \"bio\": \"I am raising funds for this service trip.\",\n  \"video_url\": \"https://www.youtube.com/watch?v=abc123\",\n  \"social_links\": {},\n  \"is_minor\": false,\n  \"guardian_name\": \"Jordan Taylor\",\n  \"guardian_email\": \"guardian@example.org\",\n  \"guardian_phone\": \"+15557654321\",\n  \"guardian_relationship\": \"Parent\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gratona.com/v1/frontend/public/trips/{clientSlugOrId}/{tripSlug}/request-to-join")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"participant@example.org\",\n  \"type\": \"INDIVIDUAL\",\n  \"organization_name\": \"Acme Foundation\",\n  \"policy_revision\": \"current-form-revision\",\n  \"first_name\": \"Sam\",\n  \"last_name\": \"Taylor\",\n  \"phone\": \"+15551234567\",\n  \"country_code\": \"US\",\n  \"subdivision_code\": \"US-CA\",\n  \"individual_goal\": 2500,\n  \"is_public\": true,\n  \"is_anonymous\": false,\n  \"bio\": \"I am raising funds for this service trip.\",\n  \"video_url\": \"https://www.youtube.com/watch?v=abc123\",\n  \"social_links\": {},\n  \"is_minor\": false,\n  \"guardian_name\": \"Jordan Taylor\",\n  \"guardian_email\": \"guardian@example.org\",\n  \"guardian_phone\": \"+15557654321\",\n  \"guardian_relationship\": \"Parent\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gratona.com/v1/frontend/public/trips/{clientSlugOrId}/{tripSlug}/request-to-join")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"participant@example.org\",\n  \"type\": \"INDIVIDUAL\",\n  \"organization_name\": \"Acme Foundation\",\n  \"policy_revision\": \"current-form-revision\",\n  \"first_name\": \"Sam\",\n  \"last_name\": \"Taylor\",\n  \"phone\": \"+15551234567\",\n  \"country_code\": \"US\",\n  \"subdivision_code\": \"US-CA\",\n  \"individual_goal\": 2500,\n  \"is_public\": true,\n  \"is_anonymous\": false,\n  \"bio\": \"I am raising funds for this service trip.\",\n  \"video_url\": \"https://www.youtube.com/watch?v=abc123\",\n  \"social_links\": {},\n  \"is_minor\": false,\n  \"guardian_name\": \"Jordan Taylor\",\n  \"guardian_email\": \"guardian@example.org\",\n  \"guardian_phone\": \"+15557654321\",\n  \"guardian_relationship\": \"Parent\"\n}"

response = http.request(request)
puts response.read_body

{
  "message": "Your request to join has been received.",
  "data": {
    "participant_id": 9001,
    "status": "requested"
  }
}

{
  "message": "Not Found",
  "status": "error"
}

{
  "errors": {},
  "status": "error",
  "message": "The given data was invalid."
}

Path Parameters

clientSlugOrId

string

required

Organization identifier from the public trip URL. Numeric values are treated as client ids; non-numeric values are matched to organization slugs.

tripSlug

string

required

Active trip slug within the resolved client. The controller rejects inactive, completed, missing, or request-disabled trips.

Body

application/json

Public join-request donor and participant details. Validator rule always requires email; additional required keys are dynamic based on the trip donor form's public standardized fields and required custom fields.

string<email>

required

Participant donor email. Validator rule: required|email|max:255. Existing donors are reused by client/email; otherwise the service creates a donor.

Maximum string length: 255

Example:

"participant@example.org"

type

enum<string>

default:INDIVIDUAL

Donor identity type; defaults to INDIVIDUAL when neither type nor donor_type is supplied.

Available options:

INDIVIDUAL,

ORGANIZATION

Example:

"INDIVIDUAL"

organization_name

string

Required when the normalized donor type is ORGANIZATION.

Maximum string length: 255

Example:

"Acme Foundation"

policy_revision

string

Optional revision from join_request_form. If standardized fields are enabled, an outdated supplied revision returns 409 with the current contract.

Example:

"current-form-revision"

first_name

string | null

Optional standardized donor first name stored on the donor and in donor json_fields when provided.

Example:

"Sam"

last_name

string | null

Optional standardized donor last name stored on the donor and in donor json_fields when provided.

Example:

"Taylor"

phone

string | null

Optional standardized phone value stored on the donor when provided.

Example:

"+15551234567"

country_code

string | null

Optional ISO alpha-2 country code. When standardized fields are enabled and supplied, validator rule: nullable|string|size:2|ValidCountryCode.

Required string length: 2

Example:

"US"

subdivision_code

string | null

Optional ISO subdivision code. When standardized fields are enabled and supplied, validator rule: nullable|string|max:10|ValidSubdivisionForCountry.

Maximum string length: 10

Example:

"US-CA"

individual_goal

number<float> | null

Optional participant fundraising goal. If absent the service uses the trip default individual goal.

Example:

2500

is_public

boolean | null

Optional participant visibility flag. Defaults to true when omitted.

Example:

true

is_anonymous

boolean | null

Optional anonymity flag stored on the participant.

Example:

false

bio

string | null

Optional public participant bio.

Example:

"I am raising funds for this service trip."

video_url

string | null

Optional public intro video URL.

Example:

"https://www.youtube.com/watch?v=abc123"

Optional public social links stored directly on the participant.

is_minor

boolean | null

Optional minor flag. Guardian fields are stored when supplied but are not exposed by public endpoints.

Example:

false

guardian_name

string | null

Optional guardian name for minor participants.

Example:

"Jordan Taylor"

guardian_email

string<email> | null

Optional guardian email for minor participants.

Example:

"guardian@example.org"

guardian_phone

string | null

Optional guardian phone for minor participants.

Example:

"+15557654321"

guardian_relationship

string | null

Optional guardian relationship for minor participants.

Example:

"Parent"

Response

Join request received.

message

string

Example:

"Your request to join has been received."

data

object

Show child attributes

Request to join a public trip

curl --request POST \
  --url https://api.gratona.com/v1/frontend/public/trips/{clientSlugOrId}/{tripSlug}/request-to-join \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "participant@example.org",
  "type": "INDIVIDUAL",
  "organization_name": "Acme Foundation",
  "policy_revision": "current-form-revision",
  "first_name": "Sam",
  "last_name": "Taylor",
  "phone": "+15551234567",
  "country_code": "US",
  "subdivision_code": "US-CA",
  "individual_goal": 2500,
  "is_public": true,
  "is_anonymous": false,
  "bio": "I am raising funds for this service trip.",
  "video_url": "https://www.youtube.com/watch?v=abc123",
  "social_links": {},
  "is_minor": false,
  "guardian_name": "Jordan Taylor",
  "guardian_email": "guardian@example.org",
  "guardian_phone": "+15557654321",
  "guardian_relationship": "Parent"
}
'

import requests

url = "https://api.gratona.com/v1/frontend/public/trips/{clientSlugOrId}/{tripSlug}/request-to-join"

payload = {
    "email": "participant@example.org",
    "type": "INDIVIDUAL",
    "organization_name": "Acme Foundation",
    "policy_revision": "current-form-revision",
    "first_name": "Sam",
    "last_name": "Taylor",
    "phone": "+15551234567",
    "country_code": "US",
    "subdivision_code": "US-CA",
    "individual_goal": 2500,
    "is_public": True,
    "is_anonymous": False,
    "bio": "I am raising funds for this service trip.",
    "video_url": "https://www.youtube.com/watch?v=abc123",
    "social_links": {},
    "is_minor": False,
    "guardian_name": "Jordan Taylor",
    "guardian_email": "guardian@example.org",
    "guardian_phone": "+15557654321",
    "guardian_relationship": "Parent"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    email: 'participant@example.org',
    type: 'INDIVIDUAL',
    organization_name: 'Acme Foundation',
    policy_revision: 'current-form-revision',
    first_name: 'Sam',
    last_name: 'Taylor',
    phone: '+15551234567',
    country_code: 'US',
    subdivision_code: 'US-CA',
    individual_goal: 2500,
    is_public: true,
    is_anonymous: false,
    bio: 'I am raising funds for this service trip.',
    video_url: 'https://www.youtube.com/watch?v=abc123',
    social_links: {},
    is_minor: false,
    guardian_name: 'Jordan Taylor',
    guardian_email: 'guardian@example.org',
    guardian_phone: '+15557654321',
    guardian_relationship: 'Parent'
  })
};

fetch('https://api.gratona.com/v1/frontend/public/trips/{clientSlugOrId}/{tripSlug}/request-to-join', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gratona.com/v1/frontend/public/trips/{clientSlugOrId}/{tripSlug}/request-to-join",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => 'participant@example.org',
    'type' => 'INDIVIDUAL',
    'organization_name' => 'Acme Foundation',
    'policy_revision' => 'current-form-revision',
    'first_name' => 'Sam',
    'last_name' => 'Taylor',
    'phone' => '+15551234567',
    'country_code' => 'US',
    'subdivision_code' => 'US-CA',
    'individual_goal' => 2500,
    'is_public' => true,
    'is_anonymous' => false,
    'bio' => 'I am raising funds for this service trip.',
    'video_url' => 'https://www.youtube.com/watch?v=abc123',
    'social_links' => [
        
    ],
    'is_minor' => false,
    'guardian_name' => 'Jordan Taylor',
    'guardian_email' => 'guardian@example.org',
    'guardian_phone' => '+15557654321',
    'guardian_relationship' => 'Parent'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gratona.com/v1/frontend/public/trips/{clientSlugOrId}/{tripSlug}/request-to-join"

	payload := strings.NewReader("{\n  \"email\": \"participant@example.org\",\n  \"type\": \"INDIVIDUAL\",\n  \"organization_name\": \"Acme Foundation\",\n  \"policy_revision\": \"current-form-revision\",\n  \"first_name\": \"Sam\",\n  \"last_name\": \"Taylor\",\n  \"phone\": \"+15551234567\",\n  \"country_code\": \"US\",\n  \"subdivision_code\": \"US-CA\",\n  \"individual_goal\": 2500,\n  \"is_public\": true,\n  \"is_anonymous\": false,\n  \"bio\": \"I am raising funds for this service trip.\",\n  \"video_url\": \"https://www.youtube.com/watch?v=abc123\",\n  \"social_links\": {},\n  \"is_minor\": false,\n  \"guardian_name\": \"Jordan Taylor\",\n  \"guardian_email\": \"guardian@example.org\",\n  \"guardian_phone\": \"+15557654321\",\n  \"guardian_relationship\": \"Parent\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gratona.com/v1/frontend/public/trips/{clientSlugOrId}/{tripSlug}/request-to-join")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"participant@example.org\",\n  \"type\": \"INDIVIDUAL\",\n  \"organization_name\": \"Acme Foundation\",\n  \"policy_revision\": \"current-form-revision\",\n  \"first_name\": \"Sam\",\n  \"last_name\": \"Taylor\",\n  \"phone\": \"+15551234567\",\n  \"country_code\": \"US\",\n  \"subdivision_code\": \"US-CA\",\n  \"individual_goal\": 2500,\n  \"is_public\": true,\n  \"is_anonymous\": false,\n  \"bio\": \"I am raising funds for this service trip.\",\n  \"video_url\": \"https://www.youtube.com/watch?v=abc123\",\n  \"social_links\": {},\n  \"is_minor\": false,\n  \"guardian_name\": \"Jordan Taylor\",\n  \"guardian_email\": \"guardian@example.org\",\n  \"guardian_phone\": \"+15557654321\",\n  \"guardian_relationship\": \"Parent\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gratona.com/v1/frontend/public/trips/{clientSlugOrId}/{tripSlug}/request-to-join")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"participant@example.org\",\n  \"type\": \"INDIVIDUAL\",\n  \"organization_name\": \"Acme Foundation\",\n  \"policy_revision\": \"current-form-revision\",\n  \"first_name\": \"Sam\",\n  \"last_name\": \"Taylor\",\n  \"phone\": \"+15551234567\",\n  \"country_code\": \"US\",\n  \"subdivision_code\": \"US-CA\",\n  \"individual_goal\": 2500,\n  \"is_public\": true,\n  \"is_anonymous\": false,\n  \"bio\": \"I am raising funds for this service trip.\",\n  \"video_url\": \"https://www.youtube.com/watch?v=abc123\",\n  \"social_links\": {},\n  \"is_minor\": false,\n  \"guardian_name\": \"Jordan Taylor\",\n  \"guardian_email\": \"guardian@example.org\",\n  \"guardian_phone\": \"+15557654321\",\n  \"guardian_relationship\": \"Parent\"\n}"

response = http.request(request)
puts response.read_body

{
  "message": "Your request to join has been received.",
  "data": {
    "participant_id": 9001,
    "status": "requested"
  }
}

{
  "message": "Not Found",
  "status": "error"
}

{
  "errors": {},
  "status": "error",
  "message": "The given data was invalid."
}

Overview

Admin

Admin Dashboard

Auth

Client

Communications

Donations

Donor Portal

Donor Signup

Donors

Email Settings

Entities

Files

Forms

Frontend

Historical Archived Updates

Payments

Programs

Public

Recipient Portal

Reports

Sponsorships

Team & Access

Trips

User

Webhooks

Wrapped

Request to join a public trip

Path Parameters

Body

Response