Skip to main content
POST
/
entities
Create Entity
curl --request POST \
  --url https://api.geogen.io/v1/entities \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "domain": "<string>",
  "models": [
    "<string>"
  ],
  "description": "<string>",
  "language": "en",
  "geolocation": "global",
  "trackingType": "website",
  "generatePrompts": true,
  "startTracking": true
}
'
{
  "success": true,
  "data": {
    "id": "<string>",
    "name": "<string>",
    "target": "<string>",
    "targetType": "url",
    "description": "<string>",
    "faviconUrl": "<string>",
    "language": "<string>",
    "geolocation": "<string>",
    "isActive": true
  },
  "promptsGenerated": 123,
  "trackingStarted": true,
  "message": "<string>"
}

Authorizations

Authorization
string
header
required

API key authentication. Format: Bearer wsk_your_api_key

Body

application/json
name
string
required

Entity display name

domain
string
required

Website domain (e.g., example.com)

models
string[]
required

Array of model UUIDs from /v1/models

description
string

Entity description

language
string
default:en

Language code

geolocation
string
default:global

Geolocation code

trackingType
enum<string>
default:website

Type of tracking

Available options:
website,
individual
generatePrompts
boolean
default:true

Auto-generate AI prompts

startTracking
boolean
default:true

Start tracking immediately

Response

Entity created successfully

success
boolean
data
object
promptsGenerated
number
trackingStarted
boolean
message
string