Skip to content
ansvra.Documentation
Projects
Projects

Create project

Create a project without enabling tracking schedules or automatic email.

POST/projects
Required permission projects:write

An unrestricted account key owned by a current account Admin is required.

Authentication and permissions · Errors and limits

Authorization

Authorizationstring · headerRequired

Bearer access key. Never put a key in the URL.

Idempotency-Keystring · headerRequired

Required for creation: 1–128 letters, numbers, dots, underscores, colons or hyphens. Reuse for retries of the same request within 24 hours.

Request body

application/json. Unknown fields are rejected.

namestringRequired

Project name: 1–100 characters.

workspaceIdstringRequired

Active workspace in this account.

domainstringRequired

Public website domain, up to 500 characters; no credentials or port.

websiteUrlstring | nullOptional

Optional HTTP(S) URL on the project domain, up to 2,000 characters.

marketstringRequired

Supported country code.

languagestringRequired

Supported language code.

targetStatestring | nullOptional

Supported two-letter US state, or null for all states.

brandAliasesstring[]Optional

Up to 30 additional names, each 1–200 characters.

domainAliasesstring[]Optional

Up to 30 public website domains.

includeSubdomainsbooleanOptional

Include subdomains in website matching.

Response fields

dataobjectRequired

Create a project without enabling tracking schedules or automatic email.

Child fields
idstringRequired

Project identifier.

workspaceIdstringRequired

Owning workspace.

namestringRequired

Project name.

domainstringRequired

Primary website domain.

websiteUrlstring | nullRequired

Website scope URL.

marketstringRequired

Country code.

targetStatestring | nullRequired

US state code, if selected.

languagestringRequired

Language code.

brandAliasesstring[]Required

Additional brand names.

domainAliasesstring[]Required

Additional website domains.

includeSubdomainsbooleanRequired

Whether subdomains are included.

archivedbooleanRequired

Whether the project is archived.

createdAtISO 8601 timestampRequired

When the project was created.

metaobjectRequired

Request metadata. Present on JSON success responses.

Child fields
requestIdstringRequired

Request identifier to include when contacting support.

resultScope"saved"Required

Saved customer information; excludes Overview preview results.

Ansvra

A clearer next step.

MEET YOUR AI GUIDE

A little clarity.
A clearer next move.

Ask about Ansvra, AI visibility, or your next step with content.

Opening chat…