List Lead Groups

Search and paginate through your account's lead groups. Use this to discover the group names you need to pass to lead_group_name in the upsert-lead request.

List-only via API

Only listing lead groups is supported via API. To create, edit, or delete lead groups, use the Superfone dashboard.

Authentication Required

Requires the x-api-key header. See Overview for details.

HTTP Request

GET /enterprise/api/lead-group

Query Parameters

Parameter	Type	Required	Default	Description
text	string	No	—	Case-insensitive substring filter on the group title
page	number	No	1	Page number — starts at 1, not 0
page_size	number	No	50	Items per page

Try it

Loading playground…

Code Examples

cURL

curl -X GET "https://prod-api.superfone.co.in/superfone/enterprise/api/lead-group?text=inbound" \
  -H "x-api-key: your_api_key_here"

JavaScript

const url = new URL(
  'https://prod-api.superfone.co.in/superfone/enterprise/api/lead-group'
);
url.searchParams.set('text', 'inbound');

const response = await fetch(url, {
  method: 'GET',
  headers: { 'x-api-key': process.env.SF_API_KEY }
});

const result = await response.json();
console.log(result.data.rows);

Python

import os
import requests

response = requests.get(
    'https://prod-api.superfone.co.in/superfone/enterprise/api/lead-group',
    headers={'x-api-key': os.environ['SF_API_KEY']},
    params={'text': 'inbound'}
)
print(response.json()['data'])

Success Response

Status Code: 200 OK

{
  "data": {
    "rows": [
      {
        "id": 3,
        "org_id": 42,
        "title": "Inbound",
        "status": "ACTIVE",
        "type": null,
        "created_by": 678,
        "updated_by": null,
        "created_at": "2026-01-15T09:00:00.000Z",
        "updated_at": "2026-01-15T09:00:00.000Z"
      }
    ],
    "total_pages": 1,
    "current_page": 1,
    "page_size": 50,
    "total_items": 1
  },
  "message": "success"
}

Response Fields

Field	Type	Description
data.rows[].id	number	Internal lead group ID
data.rows[].title	string	Group name — this is the value to pass as lead_group_name
data.rows[].status	string	ACTIVE or DISABLED
data.rows[].type	string | null	Optional group type tag
data.rows[].created_at	string	ISO 8601 timestamp
data.rows[].updated_at	string	ISO 8601 timestamp

Group names must be unique to be used in upsert

Create or Update Lead matches groups by name. If two groups share a title, the upsert call returns 400 Multiple lead groups found with this name. Provide unique — keep names unique.

Error Responses

Status	Message	When it occurs
401	UnAuthorized, Please Provide Valid API Key	Missing or invalid x-api-key

Related Endpoints

• Create or Update Lead — Pass the returned title value as lead_group_name