Create Lead LabelBeta

Create a lead label.

POSThttps://api.foxreach.io/api/v1/lead-labels

Request Body#

namestringbodyrequired

1 to 60 characters. Unique per workspace, ignoring case (409 otherwise).

colorstringbody

neutral (default), brand, success, warning, error or info.

meaningstringbody

positive, neutral (default) or negative.

Response#

Returns 201 with the label in data.

dataobject

Show Label object

idstring

Label id.

namestring

Label name, unique per workspace ignoring case.

colorstring

Color token: neutral, brand, success, warning, error or info.

meaningstring

positive, neutral or negative. Informational; it does not affect sending.

createdAtstring

ISO 8601 timestamp.

Rate Limit#

120 requests per minute, shared by every write call in your workspace. Fixed 60-second window.
Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (write).
A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns, see Rate Limiting.

Request

cURL

curl -X POST "https://api.foxreach.io/api/v1/lead-labels" \
  -H "X-API-Key: otr_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "Hot", "color": "success", "meaning": "positive"}'

Response

JSON

{
  "data": { "id": "cll_abc123", "name": "Hot", "color": "success", "meaning": "positive", "createdAt": "2026-11-04T09:00:00+00:00" }
}

Was this page helpful?

View as MarkdownLast updated November 4, 2026