Forms API
GET /api/v1/forms
Returns every lead-capture form in the workspace, newest first. Requires the read:forms scope (or *). Forms are created and edited in the app under Settings, Lead capture.
GET /api/v1/forms HTTP/1.1
Host: agentlyleads.com
Authorization: Bearer alk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxResponse: 200
{
"forms": [
{
"id": "cmq7form0alk34567890",
"name": "Contact us",
"fields": ["name", "email", "company", "message"],
"active": true,
"successMessage": "Thanks, we'll be in touch shortly.",
"allowedDomains": ["example.com"],
"submissionCount": 42,
"createdAt": "2026-08-14T10:00:00.000Z"
}
]
}| Field | Notes |
|---|---|
fields | The inputs the form shows, in order. Any of name, email, phone, company, message |
active | An inactive form rejects submissions |
allowedDomains | Sites allowed to post to the form. Empty means any site |
submissionCount | Every accepted submission, including repeats from the same person |
To send a lead in from your own code rather than an embedded form, use POST /api/v1/leads. To embed a form on your site, see Embedded form.