Health & Public Endpoints

These endpoints do not require an API key.

Health Check

GET /v1/health

Returns a simple status indicating the API is running.

Response — 200 OK

{
  "status": "ok"
}

---

Public Form Submission

POST /v1/public/form-submission/:tenant_id/:form_id

Accepts form submissions from your website. Authentication is handled through domain verification rather than API keys.

Path Parameters

Parameter	Type	Description
tenant_id	string	Your Pathbound tenant ID.
form_id	string	The form identifier.

Request Body

Field	Type	Required	Description
visitor_id	string	no	Visitor tracking ID from the Pathbound tracker.
contact_data	object	yes	Must include email. Additional fields optional.
company_data	object	no	Must include domain if provided.

Example

curl -X POST https://api.pathbound.io/v1/public/form-submission/tenant_abc/form_xyz \
  -H "Content-Type: application/json" \
  -d '{
    "visitor_id": "vis_123",
    "contact_data": {
      "email": "lead@example.com",
      "firstName": "Alex"
    },
    "company_data": {
      "domain": "example.com"
    }
  }'

Response — 201 Created

{
  "status": "success",
  "contact_id": "ct_abc",
  "company_id": "co_xyz"
}

Error Codes

Status	Meaning
400	Invalid request body.
403	Domain not allowed for this tenant.
429	Rate limit exceeded — smart and tenant-level.