{"uid":"cap_MD1DZWdO_T9QSaLU_oNTd","slug":"esyurl-custom-domain-registration-19c3f5d7","name":"esyURL Custom Domain Registration","description":"esyURL: short links, QR codes, redirect rules, custom domains and visit analytics, managed by your AI agent over MCP or REST. Since 2007.","url":"https://esyurl.fyi/v1/domain?utm_source=zero.xyz","method":"PUT","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"A domain you control, e.g. go.acme.com"}}},"type":{"type":"string","const":"http"},"method":{"enum":["PUT"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"domain":"go.example.com","status":"pending_validation","dnsRecords":[{"done":false,"name":"_acme-challenge.go.example.com","type":"TXT","value":"...","purpose":"certificate_validation"}],"instructions":"Create the DNS records listed, then GET /v1/domain to move the setup forward."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tiBLnFjtHnSVGb1essJ5A","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"5","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Registers a custom domain (e.g. go.acme.com) with esyURL so it can be used for branded short links, returning DNS records required to validate ownership and provision a certificate.","exampleAgentPrompt":"Register go.acme.com as a custom domain on esyURL so I can use it for branded short links — give me the DNS records I need to add to verify it.","exampleUseCases":[{"title":"Branded short links for a startup","prompt":"Add go.startupname.io as a custom domain on esyURL so our team can use it for branded short links — I'll need the DNS records to paste into our registrar."},{"title":"Agency white-label domain setup","prompt":"Set up links.clientbrand.com as a custom short-link domain on esyURL for one of my clients — what DNS records do I need to create to get it validated?"},{"title":"Product launch redirect domain","prompt":"Register launch.myproduct.com with esyURL so I can use it for all the QR codes and short links in our campaign — tell me what DNS entries to add."}],"resultDescription":"Returns the domain name, a status of 'pending_validation', and an array of DNS records (name, type, value, purpose) that must be created at the DNS registrar to prove ownership and provision a TLS certificate. Also includes a human-readable instruction string explaining the next step (GET /v1/domain to advance setup).","failureModes":["Domain already registered to another account — conflict error","Invalid domain format — validation error on input","DNS records not yet created — domain stays in pending_validation state","Payment failure — x402 payment required before processing","Domain not publicly resolvable — may cause certificate provisioning issues"],"whenToPreferThis":"Use this endpoint when you need to attach a user-controlled domain (e.g. go.company.com) to esyURL for branded short links and QR codes. It is the first step in the custom domain setup flow; prefer it over generic domain registration APIs because it integrates directly with esyURL's link routing, certificate provisioning, and analytics pipeline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:37:36.847Z","isFirstParty":false,"canonicalSlug":"esyurl-custom-domain-registration-19c3f5d7"}