Skip to main content
POST
/
api
/
waiting-list
curl -X POST https://www.wiseyield.co/api/waiting-list \
  -H "Content-Type: application/json" \
  -d '{
    "email": "john@example.com",
    "fullName": "John Smith",
    "farmName": "Green Valley Farm",
    "city": "Des Moines",
    "country": "United States",
    "farmSize": "250",
    "sizeUnit": "acres",
    "cropsInterest": "Corn, Soybeans"
  }'
{
  "success": true,
  "message": "Successfully joined the waiting list!",
  "data": {
    "id": "wl_..."
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.wiseyield.co/llms.txt

Use this file to discover all available pages before exploring further.

The waiting list endpoint accepts unauthenticated submissions and persists them with a confirmation email sent asynchronously.
POST https://www.wiseyield.co/api/waiting-list
Public endpoint. No authentication required. Submissions are deduplicated by email.

Request body

Only two fields are required. Everything else is optional and intended to surface higher-priority leads during onboarding.

Required

email
string
required
Valid email address. Duplicates return 409 Conflict.
fullName
string
required
2–100 characters.

Optional

farmName
string
Up to 100 characters.
city
string
Up to 100 characters.
country
string
Up to 100 characters.
farmSize
string
Numeric string (e.g. "250"). Empty string is treated as omitted.
sizeUnit
string
One of hectares, acres, feddans.
cropsInterest
string
Free text, up to 500 characters. Stored as a single-element array on the record.
phone
string
Up to 20 characters.
currentTools
string
Up to 500 characters. Validated but not persisted — used only at form-submission time.
additionalNotes
string
Up to 500 characters. Validated but not persisted.

Response

success
boolean
true on success, false on error.
message
string
Success copy (only on success).
data
object
error
string
Human-readable error category (only on error).
details
object
Per-field validation errors when error is "Invalid form data". Object keys are field names; values are arrays of messages.
curl -X POST https://www.wiseyield.co/api/waiting-list \
  -H "Content-Type: application/json" \
  -d '{
    "email": "john@example.com",
    "fullName": "John Smith",
    "farmName": "Green Valley Farm",
    "city": "Des Moines",
    "country": "United States",
    "farmSize": "250",
    "sizeUnit": "acres",
    "cropsInterest": "Corn, Soybeans"
  }'
{
  "success": true,
  "message": "Successfully joined the waiting list!",
  "data": {
    "id": "wl_..."
  }
}

Errors

StatusWhen
400Validation failed, required field missing, or data format invalid. details may carry per-field messages.
409Email already on the waiting list.
500Unhandled server error.

Side effects

  • A confirmation email is sent asynchronously (Resend). Email delivery is non-blocking — the API returns success even if the email send fails.
  • The submission is persisted with status: "pending" and surfaces in the admin approval queue.

Notes

  • Sending the same email twice returns 409 Conflict. Users who need to update their entry should contact support@wiseyield.co.
  • currentTools and additionalNotes are accepted by the schema for backwards compatibility but are not currently persisted to the record. Use cropsInterest for any free-text context you want preserved.
  • cropsInterest is normalised to a single-element array in storage. Send a comma-separated string and the API takes it as-is.