---
title: "Create a visitor"
method: POST
path: "/analytics/{connection_id}/visitor"
tags: ["analytics", "visitor"]
---

# Create a visitor

`POST /analytics/{connection_id}/visitor`

## Request

- Base URL: `http://api.unified.to`
- URL: `http://api.unified.to/analytics/{connection_id}/visitor`
- Auth: API key in header `authorization`

## Path parameters

- `connection_id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- AnalyticsVisitor
  - `id` string
  - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `property_id` string: points to AnalyticsProperty
  - `email` string
  - `name` string
  - `first_name` string
  - `last_name` string
  - `age` number
  - `gender` 'MALE' | 'FEMALE' | 'INTERSEX' | 'TRANS' | 'NON_BINARY'
  - `country` string
  - `country_code` string
  - `city` string
  - `language` string
  - `timezone` string
  - `first_seen_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `last_seen_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `total_sessions` number
  - `total_page_views` number
  - `total_events` number
  - `metadata` AnalyticsVisitorMetadata
  - `raw` unknown

## Response `200`

Successful

- AnalyticsVisitor
  - `id` string
  - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `property_id` string: points to AnalyticsProperty
  - `email` string
  - `name` string
  - `first_name` string
  - `last_name` string
  - `age` number
  - `gender` 'MALE' | 'FEMALE' | 'INTERSEX' | 'TRANS' | 'NON_BINARY'
  - `country` string
  - `country_code` string
  - `city` string
  - `language` string
  - `timezone` string
  - `first_seen_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `last_seen_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `total_sessions` number
  - `total_page_views` number
  - `total_events` number
  - `metadata` AnalyticsVisitorMetadata
  - `raw` unknown

---

[API](https://skmtc.dev/unified/apis/unified-to-api-2.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api-2/revisions/7a38bdd7f089?raw)