Lead Collection

POST /api/lead

Store lead email addresses submitted through the landing page. This endpoint is triggered by the ButtonLead component.

Request

string

required

Email address of the lead. Must be a valid email format.

Response

object

Empty object returned on successful lead storage.

string

Error message returned when request fails.

Code Examples

curl -X POST https://8space.app/api/lead \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com"
  }'

const response = await fetch('https://8space.app/api/lead', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: 'user@example.com'
  })
});

const data = await response.json();

interface LeadRequest {
  email: string;
}

const response = await fetch('https://8space.app/api/lead', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: 'user@example.com'
  } as LeadRequest)
});

if (!response.ok) {
  const error = await response.json();
  throw new Error(error.error);
}

Request Validation

The endpoint validates the following:

Email presence: The email field must be provided in the request body
Email format: Must be a valid email address format

Validation Code

packages/landing/app/api/lead/route.ts

export async function POST(req: NextRequest) {
  const body = await req.json();

  if (!body.email) {
    return NextResponse.json({ error: "Email is required" }, { status: 400 });
  }

  try {
    // TODO: Add your own lead storage logic here
    // For instance, save to Supabase or send a welcome email
    return NextResponse.json({});
  } catch (e: any) {
    console.error(e);
    return NextResponse.json({ error: e.message }, { status: 500 });
  }
}

Error Handling

error

Validation ErrorReturned when:

Email field is missing from request body

{
  "error": "Email is required"
}

error

Internal Server ErrorReturned when:

Database operation fails
Unexpected server error occurs

{
  "error": "Error message details"
}

Success Response

Status Code: 200 OK

{}

Implementation Notes

The current implementation includes a TODO for adding custom lead storage logic
Consider integrating with Supabase for lead storage or sending welcome emails
All errors are logged to the console for debugging

Overview

Landing API

Supabase API

Lead Collection

POST /api/lead

Request

Response

Code Examples

Request Validation

Error Handling

Success Response

Implementation Notes

​POST /api/lead

​Request

​Response

​Code Examples

​Request Validation

​Error Handling

​Success Response

​Implementation Notes

POST /api/lead

Request

Response

Code Examples

Request Validation

Error Handling

Success Response

Implementation Notes