Skip to main content
POST
/
v2
/
icp-criteria
Create an ICP criteria
curl --request POST \
  --url https://api.tamtam.ai/api/v2/icp-criteria \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "tier": 123,
  "employees_max": 123,
  "employees_min": 123,
  "hq_country_codes": [
    "<string>"
  ],
  "industry_excludes": [
    "<string>"
  ],
  "industry_includes": [
    "<string>"
  ],
  "user_email": "<string>"
}
'
{
  "criteria": [
    {
      "account_criteria_id": "<string>",
      "id": "<string>",
      "rule": {
        "bool_eq": true,
        "contains": [
          "<string>"
        ],
        "eq": 123,
        "gt": 123,
        "gte": 123,
        "lt": 123,
        "lte": 123,
        "not_contains": [
          "<string>"
        ]
      }
    }
  ],
  "hq_country_codes": [
    "<string>"
  ],
  "id": "<string>",
  "industry_excludes": [
    "<string>"
  ],
  "industry_includes": [
    "<string>"
  ],
  "name": "<string>",
  "tier": 123,
  "employees_max": 123,
  "employees_min": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.api.tamtam.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Account API key passed in the Authorization header

Body

application/json
name
string
required

ICP criteria name

Example:

"Enterprise EMEA"

tier
integer<int32>
required

Priority tier (lower = higher priority)

Example:

1

employees_max
integer<int32>

Maximum employee count

Example:

500

employees_min
integer<int32>

Minimum employee count

Example:

50

hq_country_codes
string[] | null

HQ country codes filter

Example:
["FR", "DE"]
industry_excludes
string[] | null

Industry names to exclude (from the industries reference list)

Example:
["Gambling"]
industry_includes
string[] | null

Industry names to include (from the industries reference list)

Example:
["Software Development"]
user_email
string

Email of the user who creates this ICP criteria (for attribution)

Example:

"elliot@tamtam.ai"

Response

Created

criteria
object[] | null
required

Custom account criteria rules

hq_country_codes
string[] | null
required

HQ country codes filter

id
string
required

ICP criteria UUID

industry_excludes
string[] | null
required

Industry names to exclude

industry_includes
string[] | null
required

Industry names to include

name
string
required

ICP criteria name

tier
integer<int32>
required

Priority tier (lower = higher priority)

employees_max
integer<int32>

Maximum employee count

employees_min
integer<int32>

Minimum employee count