API Reference/Landing Pages
POST/landing-pages/{id}/deploy

Deploy a landing page

Auth
Bearer API key
Content-Type
application/json

Request

Path parameters

FieldTypeDescription
idrequired
string

Body

FieldTypeDescription
subdomain
string
customDomain
string
Example request body
{
  "subdomain": "string",
  "customDomain": "string"
}

Code samples

curl -X POST 'https://namemy.app/api/v1/landing-pages/{id}/deploy' \
  -H 'Authorization: Bearer nma_live_...' \
  -H 'Content-Type: application/json' \
  -d '{
  "subdomain": "string",
  "customDomain": "string"
}'

Responses

200Deployment result
FieldTypeDescription
id
string
status
string

One of: "deployed", "failed"

subdomain
string
deploymentUrl
string
error
string
Example
{
  "id": "string",
  "status": "deployed",
  "subdomain": "string",
  "deploymentUrl": "string",
  "error": "string"
}
402Payment required — endpoint gated by subscription or one-time add-on
FieldTypeDescription
error
string
code
string
productType
string
productName
string
oneTimePrice
number
recurring
string

One of: "one-time", "monthly", "yearly"

message
string
upgrade
object
Example
{
  "error": "Payment required",
  "code": "entitlement_required",
  "productType": "BRAND_KIT",
  "productName": "Brand Kit",
  "oneTimePrice": 29.99,
  "recurring": "one-time",
  "message": "string",
  "upgrade": {
    "subscription": "string",
    "oneTimePurchase": "string"
  }
}
404Resource not found
FieldTypeDescription
error
string
code
string
Example
{
  "error": "Not found",
  "code": "not_found"
}
429Rate limit or daily quota exceeded
FieldTypeDescription
error
string
code
string

One of: "rate_limit_exceeded", "daily_quota_exceeded"

tier
string

One of: "explorer", "founder", "agency"

limit
integer
upgrade
string
Example
{
  "error": "string",
  "code": "rate_limit_exceeded",
  "tier": "explorer",
  "limit": 0,
  "upgrade": "https://namemy.app/pricing"
}
←PreviousPOST/landing-pagesNextPOST/brand-kits→