{"method":"POST","path":"https://api.revcent.com/v2/tracking_domains","summary":"Create A Tracking Domain","description":"Create a Tracking Domain, which will issue a unique Tracking Domain ID. After creating the tracking domain, the response will contain necessary A records in the 'a_records' array, which you will need to add to the domain's DNS. Once you have added the A records to your domain's DNS, you can begin the InitializeTrackingDomainSSL operation to initialize SSL for the domain. You can retrieve the required A records in the response when you first create the tracking domain, or you can use the GetTrackingDomain operation at any time to retrieve the A records.<br><br>Steps for DNS tracking:<br><br>1. Create a tracking domain using the CreateTrackingDomain operation.<br><br>2. Add the A records in the CreateTrackingDomain response to your domain's DNS settings.<br><br>3. Initialize SSL for the tracking domain using the InitializeTrackingDomainSSL operation.<br><br>4. Add the CNAME records in the InitializeTrackingDomainSSL response to your domain's DNS settings.<br><br>5. Complete the DNS tracking setup by performing the InitializeTrackingDomainDNS operation. View markdown documentation at https://revcent.com/documentation/markdown/mcp/operation/CreateTrackingDomain.md for an in-depth overview of this operation.","operationId":"CreateTrackingDomain","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"name":{"type":"string","description":"The Tracking Domain name. Must be unique from other Tracking Domain names."},"description":{"type":"string","description":"The Tracking Domain description."},"domain":{"type":"string","description":"The Tracking Domain. The root domain, no subdomain such as 'www'. Only requests that come from the root domain will be tracked. Must be a valid domain that you own and have access to modify the DNS records for. For example, mydomain.com. Once created the domain cannot be modified."}},"required":["name"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"API call response code.","type":"integer","format":"int32","enum":[1]},"tracking_domain_id":{"type":"string","description":"A 20 character tracking domain ID.","minLength":20,"maxLength":20},"a_records":{"items":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","description":"The A record name.."},"value":{"type":"string","description":"The value for the A record."}}},"type":"array","description":"An array of A records that will need to be entered into your domain's DNS settings after creating the tracking domain. Once you have added the A records you can begin the InitializeTrackingDomainSSL operation."},"result":{"type":"string"}},"type":"object","additionalProperties":false}}},"description":"Successful response."},"default":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"This value indicates that there is an error. Will always be 0.","type":"integer","enum":[0]},"error_code":{"description":"The specific error code.","type":"string"},"message":{"description":"A human readable description of the error.","type":"string"},"result":{"description":"A description of the API call result.","type":"string"}},"title":"APIStandardErrors","type":"object","additionalProperties":false}}},"description":"Error response."}}}