Site templates

Create a site template

A template is a reusable bundle of site settings (no url/paused/labels). Only name is required; every other field defaults to a new-template configuration. Exceeding the per-account cap returns 403 template_limit_reached.

post/v1/site-templates

Request

Base URL: https://api.feelingsurf.fr
URL: https://api.feelingsurf.fr/v1/site-templates
Auth: HTTP bearer

Request body

namestring nullable required

Template name.

visit_distribution'even' | 'asap'

How visits are paced — "even" spreads them across the day, "asap" delivers as fast as possible.

traffic_sourcesinteger[]

IDs of traffic sources to assign.

Response

The created template.

idinteger

Unique identifier.

namestring nullable

Template name.

visit_distribution'even' | 'asap'

How visits are paced — "even" spreads them across the day, "asap" delivers as fast as possible.

traffic_sourcesinteger[]

IDs of assigned traffic sources (resolve via GET /v1/traffic-sources).

created_atstring date-time nullable

When it was created (UTC), or null.

Example response

{
  "id": 2644,
  "name": "Default desktop",
  "devices": {
    "desktop": 100,
    "mobile": 0,
    "tablet": 0
  },
  "visit_duration": {
    "min_seconds": 10,
    "max_seconds": 10
  },
  "visit_distribution": "even",
  "limits": {
    "hourly": 50,
    "daily": null,
    "total": null
  },
  "schedule": {
    "active_hours_mask": null,
    "time_zone": null
  },
  "traffic_quality": {
    "low_quality_ips": true,
    "ipv6": true
  },
  "browsing": {
    "max_sub_windows": 0
  },
  "location_targeting": {
    "mode": "include",
    "locations": []
  },
  "blocked_domains": {
    "rate": 100,
    "domains": []
  },
  "actions": {
    "window": "latest",
    "items": []
  },
  "cookies": [],
  "traffic_sources": [],
  "created_at": "2026-06-25T07:58:02Z"
}

Changes

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