post
https://{yourinstance}.makaira.io/storefront/domains
Adds a new custom domain to the storefront.
Adds a new custom domain to the storefront.
Requires the storefront:domains:write or storefront.write permission.
Request
POST /storefront/domains
Headers
| Header | Value |
|---|---|
Authorization | Bearer <token> |
Content-Type | application/x-www-form-urlencoded |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
hostname | string | Yes | The fully-qualified domain name to add (e.g. www.myshop.com). |
Example Request
POST /storefront/domains
Content-Type: application/x-www-form-urlencoded
hostname=www.myshop.comResponse
Returns the created domain object with the same fields as List storefront domains.
Example Response
{
"id": "def456",
"hostname": "www.myshop.com",
"kind": "custom",
"status": "pending"
}