{"uid":"cap_1DytKNVxE-5TiTMrmD3pf","slug":"domains-rapidruntime-com-set-domain-whois-contacts-a8de62ce","name":"Set Domain WHOIS Contacts","description":"Replace all four WHOIS contacts (registrant, admin, tech, billing). All must be provided — partial updates are not supported.","url":"https://domains.rapidruntime.com/api/v1/domains/{domain}/contacts","method":"POST","headers":{},"bodySchema":{"type":"object","required":["contacts"],"properties":{"contacts":{"type":"object","required":["registrant","admin","tech","billing"],"properties":{"tech":{"type":"object","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"fax":{"type":"string"},"zip":{"type":"string"},"city":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"},"companyName":{"type":"string"}}},"admin":{"type":"object","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"fax":{"type":"string"},"zip":{"type":"string"},"city":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"},"companyName":{"type":"string"}}},"billing":{"type":"object","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"fax":{"type":"string"},"zip":{"type":"string"},"city":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"},"companyName":{"type":"string"}}},"registrant":{"type":"object","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"fax":{"type":"string"},"zip":{"type":"string"},"city":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"},"companyName":{"type":"string"}}}}}}},"responseSchema":{"type":"object","required":["domainName","locked","autorenewEnabled","expireDate","createDate"],"properties":{"locks":{"type":"array","items":{"type":"string"}},"locked":{"type":"boolean"},"contacts":{"type":"object","required":["registrant","admin","tech","billing"],"properties":{"tech":{"type":"object","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"fax":{"type":"string"},"zip":{"type":"string"},"city":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"},"companyName":{"type":"string"}}},"admin":{"type":"object","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"fax":{"type":"string"},"zip":{"type":"string"},"city":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"},"companyName":{"type":"string"}}},"billing":{"type":"object","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"fax":{"type":"string"},"zip":{"type":"string"},"city":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"},"companyName":{"type":"string"}}},"registrant":{"type":"object","required":["firstName","lastName","address1","city","state","zip","country","email","phone"],"properties":{"fax":{"type":"string"},"zip":{"type":"string"},"city":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"state":{"type":"string"},"country":{"type":"string"},"address1":{"type":"string"},"address2":{"type":"string"},"lastName":{"type":"string"},"firstName":{"type":"string"},"companyName":{"type":"string"}}}}},"createDate":{"type":"string"},"domainName":{"type":"string"},"expireDate":{"type":"string"},"nameservers":{"type":"array","items":{"type":"string"}},"renewalPrice":{"type":"number"},"privacyEnabled":{"type":"boolean"},"autorenewEnabled":{"type":"boolean"}}},"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_E2IZiJhbEVo-l949o2WIJ","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":"Replace all four WHOIS contacts (registrant, admin, tech, billing) for a domain — full replacement only, no partial updates.","exampleAgentPrompt":"Update all the WHOIS contacts for example.com — set the registrant, admin, tech, and billing contact to Jane Smith, 123 Main St, Austin, TX 78701, US, jane@example.com, +1.5125550100, company Acme Corp.","exampleUseCases":[{"title":"Company rebrand contact consolidation","prompt":"We're rebranding our company and moving offices. Update all WHOIS contacts for our domain acmeinc.com to our new details: registrant and admin both to Sarah Chen, 456 Oak Avenue, San Francisco, CA 94102, US, sarah@acmeinc.com, +1.4155550200. Use the same info for tech contact, but set billing contact to our CFO Michael Torres at michael@acmeinc.com, +1.4155550201."},{"title":"New business ownership domain transfer","prompt":"I just acquired a startup and need to update the domain contacts immediately. Change all four WHOIS contacts for startup.io — registrant to David Kumar, 789 Pine Road, Seattle, WA 98101, US, david@startup.io, +1.2065550300, admin to Lisa Wong at lisa@startup.io, +1.2065550301, tech contact to our DevOps lead Chris Martinez at chris@startup.io, +1.2065550302, and billing to our accountant Emma Thompson at emma@startup.io, +1.2065550303."},{"title":"Standardized contacts across portfolio","prompt":"We manage multiple domains and need them all consistent. Set the WHOIS contacts for portfolio.com to use our corporate headquarters address at 321 Commerce Blvd, Boston, MA 02101, US with registrant John Phillips, admin Karen Wells, tech support team at tech@portfolio.com, and billing to our finance department at billing@portfolio.com, all with phone +1.6175550400."}],"resultDescription":"Returns the full updated domain record including the newly set registrant, admin, tech, and billing contact objects, along with domain lock status, autorenew setting, expiry date, and creation date.","failureModes":["Missing one or more of the four required contact objects returns a validation error — all four (registrant, admin, tech, billing) must be provided","Missing required contact fields (e.g. firstName, lastName, address1, city, state, zip, country, email, phone) causes a 400 error","Invalid domain name in path returns 404","Domain not owned by authenticated user returns 403","Malformed email or phone format may cause a validation error","Domain is locked and cannot be modified"],"whenToPreferThis":"Use this endpoint when you need to update any WHOIS contact information for a registered domain. Since it requires all four contacts simultaneously, it is best suited for full contact record refreshes (e.g., company rebrand, new owner, address change). Not suitable for partial/single-contact updates as the API does not support them.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T21:20:51.353Z","isFirstParty":false}