> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peec.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Facts

> 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.



## OpenAPI

````yaml https://api.peec.ai/customer/v1/openapi/json post /facts/create
openapi: 3.0.3
info:
  title: Peec AI Customer API
  description: Development documentation
  version: 1.0.0
  contact:
    name: Peec AI Team
    email: support@peec.ai
servers:
  - url: https://api.peec.ai/customer/v1
security: []
paths:
  /facts/create:
    post:
      tags:
        - Brand Perception
      summary: Create Facts
      description: >-
        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.
      operationId: postFactsCreate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                project_id:
                  description: Required if using a company api key
                  example: or_f45b94ba-5e35-4982-93ed-285e72ee14eb
                  type: string
                facts:
                  minItems: 1
                  maxItems: 50
                  type: array
                  items:
                    type: object
                    properties:
                      text:
                        type: string
                        minLength: 1
                        example: Plans start at €99 per month.
                        description: The statement Peec should check AI claims against.
                    required:
                      - text
              required:
                - facts
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                project_id:
                  description: Required if using a company api key
                  example: or_f45b94ba-5e35-4982-93ed-285e72ee14eb
                  type: string
                facts:
                  minItems: 1
                  maxItems: 50
                  type: array
                  items:
                    type: object
                    properties:
                      text:
                        type: string
                        minLength: 1
                        example: Plans start at €99 per month.
                        description: The statement Peec should check AI claims against.
                    required:
                      - text
              required:
                - facts
          multipart/form-data:
            schema:
              type: object
              properties:
                project_id:
                  description: Required if using a company api key
                  example: or_f45b94ba-5e35-4982-93ed-285e72ee14eb
                  type: string
                facts:
                  minItems: 1
                  maxItems: 50
                  type: array
                  items:
                    type: object
                    properties:
                      text:
                        type: string
                        minLength: 1
                        example: Plans start at €99 per month.
                        description: The statement Peec should check AI claims against.
                    required:
                      - text
              required:
                - facts
      responses:
        '200':
          description: Every created fact with its new id
          content:
            application/json:
              schema:
                type: object
                properties:
                  created:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          pattern: >-
                            ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                          example: 0198f000-0000-7000-8000-000000000001
                        text:
                          type: string
                          example: Plans start at €99 per month.
                          description: The statement Peec checks AI claims against.
                        origin:
                          type: string
                          enum:
                            - website
                            - manual
                          example: manual
                          description: >-
                            How the fact was added: `manual` by a person,
                            `website` extracted from the project's website.
                        is_active:
                          type: boolean
                          description: >-
                            Whether Peec uses the fact in future fact-checking.
                            An inactive fact stays listed.
                        edited_at:
                          nullable: true
                          example: '2026-09-18T10:00:00.000Z'
                          description: >-
                            When the wording was last changed, or null if never
                            edited.
                          type: string
                          format: date-time
                          pattern: >-
                            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                        created_at:
                          type: string
                          format: date-time
                          pattern: >-
                            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                          example: '2026-09-01T10:00:00.000Z'
                      required:
                        - id
                        - text
                        - origin
                        - is_active
                        - edited_at
                        - created_at
                required:
                  - created
                description: Every created fact with its new id
        '402':
          description: >-
            The project's plan does not cover this many active facts. Nothing
            was created.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
                description: >-
                  The project's plan does not cover this many active facts.
                  Nothing was created.
      security:
        - APIKeyHeader: []
        - APIKeyQuery: []
        - BearerAuth: []
components:
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    APIKeyQuery:
      type: apiKey
      in: query
      name: api_key
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.