logo LinkShift.app
Sign inStart now
logo LinkShift.app
Go to App
LinkShift docs
OpenAPI-driven API documentation
Start
Overview
API reference
Guides
LinkShift Public API Guide
Domains and Domain Groups API
Redirect Rules API
Link Maps API
Link Map Entries API
Redirect Tests API
Concepts
Link Maps: Purpose, Behavior, and Safety
API endpoints
GET List domain groups
 POST Create domain group
 GET Get domain group
 PUT Update domain group
 DELETE Delete domain group
Domains
GET List domains
 POST Create domain
 GET Get domain
 PUT Update domain
 DELETE Delete domain
GET List link map entries
 POST Create link map entry
 DELETE Delete multiple link map entries by IDs
 GET Get link map entry
 PUT Update link map entry
 DELETE Delete link map entry
 POST Import link map entries
 POST Roll back imported link map entries
GET List link maps
 POST Create link map
 GET Get link map
 PUT Update link map
 DELETE Delete link map
GET Get organization usage summary
GET List redirect rules
 POST Create redirect rule
 GET Get redirect rule
 PUT Update redirect rule
 DELETE Delete redirect rule
 GET Get top redirect rules analytics
 POST Simulate redirect rule matching
GET List redirect tests
 POST Create redirect test
 GET Get redirect test
 PUT Update redirect test
 DELETE Delete redirect test
LinkShift docs
POST

Create domain

https://linkshift.app/api/v1/domains

Creates a new domain in a target domain group after uniqueness and ownership checks.

Operation ID:createDomainTags: Domains
Back to API reference

Security

  • ApiKeyAuth: apiKey | header:X-API-Key | API key generated in LinkShift dashboard (`Organization -> Manage API keys`).

Parameters

This endpoint has no parameters.

Request body schema

requestBodyobjectrequired
Payload for creating a domain.
domainGroupIdstringrequired
Target domain-group ID.
namestringrequired
Fully qualified domain name.

Response schema

Created domain

Content type: application/json
response 200objectrequired
Domain entity assigned to a domain group.
createdAtstringrequired
Creation timestamp (UTC).
format: date-time
deletedAtstring | nullnullable
Soft-delete timestamp in UTC when deleted.
format: date-time
domainGroupIdstringrequired
Parent domain-group ID.
idstringrequired
Domain ID.
namestringrequired
Fully qualified domain name.
updatedAtstringrequired
Last update timestamp (UTC).
format: date-time