Create a Domain

Create an ingest domain name or a delivery domain name.

Request

Request-Line

POST /lls/v1.0/domain

Request Parameters

Body Parameters

Parameter	Type	Required	Description
domain	String	Mandatory	domain name
type	String	Mandatory	domain type. Valid values: ingest, delivery.

Response

Response Body

Parameter	Type	Required	Description
domain	String	Mandatory	domain name
type	String	Mandatory	domain type. Valid values: ingest, delivery.
created	Timestamp	Mandatory	Timestamp of created time in UTC timezone. Default is now.
CNAME	String	Mandatory	CNAME for domain.
status	String	Mandatory	Status of domain. Valid values: active, inactive.

Status Codes, Error Codes and Error Messages

Status Code	Error Code	Error Message
400	LLS.Domain.Invalid	Domain name invalid.

Examples

Create an ingest domain name

Request Body

{
  "domain": "ingest.example.com",
  "type": "ingest"
}

Successful Response Body

{
  "domain": "ingest.example.com",
  "type": "ingest",
  "CNAME": "1000-2000-3000.llss-ingest-sw.swiftserve.com",
  "created": "2025-07-10T09:30:00Z",
  "status": "active"
}

Create a delivery domain name

Request Body

{
  "domain": "delivery.example.com",
  "type": "delivery"
}

Successful Response Body

{
  "domain": "delivery.example.com",
  "type": "delivery",
  "CNAME": "edge.conversant.swiftserve.com",
  "created": "2025-07-10T09:35:00Z",
  "status": "active"
}

Best Practices

Rate Limiting

Rate Limits

Rate limiting is posed upon the API, please kindly check your API calls to ensure complying with the rate limit below:

• 100 requests per minute
• 1000 requests per hour