Agent Winds API Documentation

Public API endpoints for AI agents and automated systems

Rate Limit: 7 requests per hour with the public demo key

Book Consultation

Creates a consultation lead. Agent Winds will follow up using the submitted contact information.

POST

https://tophamtechbeb.com/api/toptech/onboarding/v1/request-consultation

Headers

Content-Type: application/json
X-API-Key: treas-demo-api-key

Required request body

{
  "name": "string (required)",
  "email": "email (required)",
  "phone": "string (required)",
  "brokerage": "string (required)",
  "state": "us-state-code (required)",
  "package": "pricing-plan (required)",
  "needs": "string (required)"
}

Validate all required fields before sending. The current backend can return 500 rather than 400 for some malformed consultation payloads.

name: Full name of the person requesting the consultation.
email: Email address Agent Winds may use for follow-up.
phone: Phone number Agent Winds may use for follow-up.
brokerage: Brokerage or company name.
state: Two-letter US state or District of Columbia postal abbreviation.
package: Agent Winds plan of interest.
needs: The user's goals, current website situation, and what they want help with.

Responses

200 OK - Consultation request accepted.
400 Bad Request - Invalid or missing parameters
401 Unauthorized - Missing or invalid API key
429 Too Many Requests - Demo-key rate limit exceeded
500 Internal Server Error - Server error; see validation note above

Example

curl -X POST https://tophamtechbeb.com/api/toptech/onboarding/v1/request-consultation \
  -H "Content-Type: application/json" \
  -H "X-API-Key: treas-demo-api-key" \
  -d '{
  "name": "Jordan Lee",
  "email": "jordan@example.com",
  "phone": "+1-555-555-0142",
  "brokerage": "Example Realty",
  "state": "TX",
  "package": "Single Agent",
  "needs": "I need an AI-powered IDX website with CRM lead management."
}'

Schedule Demo

Creates a demo request for a preferred date and time. The appointment is pending until Agent Winds confirms it.