{"uid":"cap_MJtRfIZJLfXgWrU3OqkTj","slug":"domains-rapidruntime-com-create-dns-record-7a993aeb","name":"Create DNS Record","description":"Create a DNS record","url":"https://domains.rapidruntime.com/api/v1/domains/{domain}/dns?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["type","host","answer"],"properties":{"ttl":{"type":"number","minimum":300,"description":"TTL in seconds (min 300)"},"host":{"type":"string","description":"Relative hostname (use \"\" for apex)"},"type":{"enum":["A","AAAA","ANAME","CNAME","MX","NS","SRV","TXT"],"type":"string","description":"Record type"},"answer":{"type":"string","description":"Record value"},"priority":{"type":"number","description":"Priority (required for MX and SRV)"}}},"responseSchema":{"type":"object","required":["host","type","answer"],"properties":{"id":{"type":"number"},"ttl":{"type":"number"},"fqdn":{"type":"string"},"host":{"type":"string"},"type":{"type":"string"},"answer":{"type":"string"},"priority":{"type":"number"},"domainName":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"0x20C000000000000000000000b9537d11c60E8b50","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","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":"free","summary":"Free","primary":{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_czA2GeaxNtfijI-3pRloB","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"domains.rapidruntime.com","brandSlug":"domains-rapidruntime-com-mpp","brandBaseUrl":"https://domains.rapidruntime.com","brandDocsUrl":null,"whatItDoes":"Creates a new DNS record (A, AAAA, CNAME, MX, TXT, etc.) for a domain managed through the RapidRuntime domains API","exampleAgentPrompt":"Add an A record to example.com pointing the subdomain 'app' to IP address 203.0.113.42 with a TTL of 300 seconds.","exampleUseCases":null,"resultDescription":"Returns the newly created DNS record object including its assigned ID, FQDN, host, record type, answer value, TTL, priority, and domain name — confirming the record was successfully created.","failureModes":["Domain not found or not owned by caller — 404 or 403 error","Missing required fields (type, host, or answer) — 400 validation error","Invalid record type (not in allowed enum) — 400 error","TTL below minimum of 300 — validation error","MX or SRV record missing required priority field — 400 error","Invalid answer format for the given record type (e.g. non-IP for A record) — 400 error","Duplicate record conflict — 409 or similar error"],"whenToPreferThis":"Use this endpoint when you need to programmatically add DNS records to a domain already registered and managed through the RapidRuntime/MPP platform. Ideal for automating DNS configuration during server provisioning, subdomain setup, email routing, or domain verification workflows within the RapidRuntime ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-06T12:33:16.587Z","isFirstParty":false,"canonicalSlug":"domains-rapidruntime-com-create-dns-record-7a993aeb"}