Skip to main content

Endpoints

MethodPathDescription
GET/api/v2/companiesList companies
POST/api/v2/companiesCreate a company

List companies

GET /api/v2/companies

Query parameters

keyword
string
Search by company name or domain (e.g. "Acme" or "acme.com").
page
number
Page number (default: 1).
limit
number
Results per page (default: 10).
curl "https://api.flowla.com/api/v2/companies?keyword=acme&page=1&limit=20" \
  -H "x-flowla-api-key: YOUR_API_KEY"

Response

results
array
Array of company objects.
totalRecords
number
Total matching companies.
totalPages
number
Total pages at the current limit.
Response 200
{
  "results": [
    { "id": "cmp_01ab2", "name": "Acme Corp", "domain": "acme.com" }
  ],
  "totalRecords": 1,
  "totalPages": 1
}

Create a company

POST /api/v2/companies
domain
string
required
Company domain (e.g. acme.com). Also used as name when name is omitted.
name
string
Company display name. Defaults to domain when not provided.
website
string
Full website URL (e.g. https://acme.com).
Example
{ "domain": "acme.com", "name": "Acme Corp" }
curl -X POST https://api.flowla.com/api/v2/companies \
  -H "x-flowla-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "acme.com", "name": "Acme Corp" }'

Response

Response 201
{
  "id": "cmp_01ab2",
  "name": "Acme Corp",
  "domain": "acme.com",
  "website": null,
  "createdAt": "2026-06-01T10:00:00.000Z"
}