/Your own API domain

Keys

Your own API domain

Call Vallkey at your own address, such as api.yourcompany.com.

Let your apps call Vallkey at your own address, such as https://api.yourcompany.com, with the same ghost keys: useful for firewall allow-lists and security reviews. Pro includes 1 domain, Team 3 and Business 10.

  1. Under Settings → API domains, add a subdomain you own. Root domains such as yourcompany.com cannot point elsewhere with a CNAME.
  2. Add the two records Vallkey shows where your DNS is managed: a CNAME to customers.vallkey.com, and a TXT record at _vallkey.your domain, which proves it is yours. The page names your DNS provider and shows where to click, and checks the records by itself.
  3. The certificate is issued within minutes. Send a test request through the domain from the same page, then make it your default address.

A domain only carries your own account's ghost keys. Every key works through every address, Vallkey's and all your domains, including domains you add later. To limit a key to some of them, choose Only some in its Addresses rule.

What the page saysWhat to do
The CNAME points to another hostChange the CNAME's value to customers.vallkey.com.
Proxied by CloudflareIn Cloudflare DNS, set the record to DNS only (grey cloud).
Only some authorities may issue certificatesAdd the CAA records shown, which allow letsencrypt.org and pki.goog.
Used by another accountAnother account proved the domain first. Write to support from your account email if it is yours.
Needs attentionA record was removed or changed, or the certificate could not renew. The page names the record to fix.

Still have a question?

We read every email, usually within a day.

Contact support