PEpeec
Brand Perception

Create Facts

Changed on

Add manual facts to a project. Each fact is a statement about the brand that Peec uses to check claims found in future AI answers. New facts are active. The batch is all or nothing: if the active facts would exceed the plan's fact_limit (see List Facts), nothing is created and the request fails with 402.

post/facts/create

Request

  • Base URL
    https://api.peec.ai/customer/v1
  • URL
    https://api.peec.ai/customer/v1/facts/create
  • Auth
    • API key in header X-API-Key
    • or API key in query parameter api_key
    • or HTTP bearer

Request body

project_idstring

Required if using a company api key

Example request

{
  "project_id": "or_f45b94ba-5e35-4982-93ed-285e72ee14eb",
  "facts": [
    {
      "text": "Plans start at €99 per month."
    }
  ]
}

Response

Every created fact with its new id

Example response

{
  "created": [
    {
      "id": "0198f000-0000-7000-8000-000000000001",
      "text": "Plans start at €99 per month.",
      "origin": "manual",
      "edited_at": "2026-09-18T10:00:00.000Z",
      "created_at": "2026-09-01T10:00:00.000Z"
    }
  ]
}

Changes