Create or clone a property

POST https://{{host}}/papi/v1/properties?contractId={{contractId}}&groupId={{groupId}}

This operation either creates a new property from scratch or bases one on another property's rule tree and optionally its set of assigned hostnames. Version 1 of a new property is created automatically. PAPI's ability to create and clone new properties means that you can design a system of rule templates targeted to specific domains, rather than maintain a single set of rules with conditional logic for your full range of domains. Maintaining properties manually within the Control Center interface limited you to that more consolidated approach, but you can deploy rules more efficiently using PAPI. In either case, PAPI makes it much easier for you to support a large, flexible set of domains.

Request Params

Key	Datatype	Description
`contractId`	string	(Required) Unique identifier for the contract. See ID prefixes for details on omitting the value's `ctr_` prefix.
`groupId`	string	(Required) Unique identifier for the group. See ID prefixes for details on omitting the value's `grp_` prefix.
`accountSwitchKey`	string	(Optional) For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Request Body

{"productId"=>"prd_Alta", "propertyName"=>"my.new.property1.com", "ruleFormat"=>"v2018-09-12"}

HEADERS

Key	Datatype	Description
`PAPI-Use-Prefixes`	string	(Required) Enum Sets whether to represent ID prefixes in response data. Set to `false` when exchanging PAPI data with other APIs.
`Content-Type`	string
`Accept`	string

RESPONSES

status: Created

{&quot;propertyLink&quot;:&quot;/papi/v0/properties/prp_173137?contractId=ctr_K-0N7RAK7\u0026groupId=grp_15225&quot;}