Create fact definition

Creates a fact definition for the calling account. The fact name must be unique within the account; the request is rejected if a fact with the same name already exists.

post/context/1/facts

Request

Base URL
https://api.infobip.com (the document declares no server; this is the origin it was published from)
Auth
- OAuth 2
  Client credentials
  Token URL: https://api.infobip.com/auth/1/oauth2/token
- or API key in header Authorization
- or API key in header Authorization
- or HTTP basic

Request body

namestring required

Fact name. Must be unique within the account.

descriptionstring required

Human-readable description of the fact.

valueType'STRING' | 'NUMBER' | 'BOOLEAN' | 'DATE' required

Supported value types for a fact definition.

Example request

{
  "name": "preferred_language",
  "description": "Customer's preferred communication language.",
  "valueType": "STRING"
}

Response

Created - the newly created fact definition

idstring uuid required

Surrogate identifier of this fact definition.

namestring required

Fact name, unique within the account.

descriptionstring required

Human-readable description of the fact.

valueType'STRING' | 'NUMBER' | 'BOOLEAN' | 'DATE' required

Supported value types for a fact definition.

createdAtstring date-time required

Timestamp (UTC, ISO-8601) when the fact definition was created.

updatedAtstring date-time required

Timestamp (UTC, ISO-8601) when the fact definition was last updated.

Example response

{
  "id": "0197a1c8-4a2b-7ef1-8b7c-3f0d2c9d3a11",
  "name": "preferred_language",
  "description": "Customer's preferred communication language.",
  "valueType": "STRING",
  "createdAt": "2026-09-15T10:12:33.421Z",
  "updatedAt": "2026-09-15T10:12:33.421Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.