Skip to content

Check a connected shop's email domain DNS

POST
/customer-email/shops/{shopId}/check
curl --request POST \
--url https://example.com/customer-email/shops/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/check \
--cookie __Host-bottle.session_token=<__Host-bottle.session_token>
shopId
required
string format: uuid

A connected shop’s sender

Media typeapplication/json
object
senderAddress
required
string | null format: email
<= 200 characters
replyTo
required
string | null format: email
<= 200 characters
shopId
required
string format: uuid
shopName
required
string
customerName
required
string | null
domain
required
string | null
status
required
string
Allowed values: default ownership_pending dns_pending verified problem
records
required
Array<object>
object
type
required
string
Allowed values: TXT MX CNAME
name
required
string
value
required
string
priority
integer
status
required
string
checkedAt
required
string | null format: date-time
problem
required
string | null
Allowed values: ownership dns provider setup

Example

{
"status": "default",
"records": [
{
"type": "TXT"
}
],
"problem": "ownership"
}

Not signed in

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}

Not permitted

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}

No such connected shop

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}

Domain already in use or must be disconnected first

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}

Invalid settings

Media typeapplication/json
object
error
required
string
Allowed values: validation
message
required
string
issues
required
Array<object>
object
path
required
string
message
required
string

Example

{
"error": "validation",
"issues": [
{
"path": "email",
"message": "Invalid email"
}
]
}