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,
  "user_email": "<string>"
}
'
{
  "criteria": [
    {
      "id": "<string>",
      "importance": "<string>",
      "rule": {
        "bool_eq": true,
        "contains": [
          "<string>"
        ],
        "eq": 123,
        "gt": 123,
        "gte": 123,
        "lt": 123,
        "lte": 123,
        "not_contains": [
          "<string>"
        ],
        "smart_verticals_contains": [
          {
            "id": "<string>",
            "name": "<string>"
          }
        ],
        "smart_verticals_not_contains": [
          {
            "id": "<string>",
            "name": "<string>"
          }
        ]
      },
      "account_criteria_id": "<string>",
      "account_criteria_name": "<string>",
      "firmographic_kind": "<string>"
    }
  ],
  "id": "<string>",
  "name": "<string>",
  "tier": 123
}

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

user_email
string

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

Example:

"elliot@tamtam.ai"

Response

Created

criteria
object[] | null
required

Rules that define this ICP — a mix of firmographic filters (HQ country, industry, employees, smart verticals, …) and custom AccountCriteria-backed rules.

id
string
required

ICP criteria UUID

name
string
required

ICP criteria name

tier
integer<int32>
required

Priority tier (lower = higher priority)