Registers a new domain name and creates a corresponding Registration resource.
Call registrations.retrieveRegisterParameters first to check availability of the domain name and determine parameters like price that are needed to build a call to this method.
A successful call creates a Registration resource in state REGISTRATION_PENDING, which resolves to ACTIVE within 1-2 minutes, indicating that the domain was successfully registered. If the resource ends up in state REGISTRATION_FAILED, it indicates that the domain was not registered successfully, and you can safely delete the resource and retry registration.
HTTP request
POST https://domains.googleapis.com/v1/{parent=projects/*/locations/*}/registrations:register
Required. Yearly price to register or renew the domain. The value that should be put here can be obtained from registrations.retrieveRegisterParameters or registrations.searchDomains calls.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-30 UTC."],[[["\u003cp\u003eThis API call registers a new domain name, creating a \u003ccode\u003eRegistration\u003c/code\u003e resource that initially enters a \u003ccode\u003eREGISTRATION_PENDING\u003c/code\u003e state and usually becomes \u003ccode\u003eACTIVE\u003c/code\u003e within a few minutes.\u003c/p\u003e\n"],["\u003cp\u003eBefore calling this method, you must call \u003ccode\u003eregistrations.retrieveRegisterParameters\u003c/code\u003e to check the domain's availability and obtain necessary registration details, such as the price.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request uses the \u003ccode\u003ePOST\u003c/code\u003e method with a URL in the format \u003ccode\u003ehttps://domains.googleapis.com/v1/{parent=projects/*/locations/*}/registrations:register\u003c/code\u003e, requiring the \u003ccode\u003edomains.registrations.create\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires fields like \u003ccode\u003eregistration\u003c/code\u003e, \u003ccode\u003edomainNotices\u003c/code\u003e, \u003ccode\u003econtactNotices\u003c/code\u003e, and \u003ccode\u003eyearlyPrice\u003c/code\u003e, all of which are essential for successfully registering the new domain.\u003c/p\u003e\n"],["\u003cp\u003eA successful call returns an \u003ccode\u003eOperation\u003c/code\u003e object, while a failed registration results in a \u003ccode\u003eREGISTRATION_FAILED\u003c/code\u003e state, allowing you to safely retry the process.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.registrations.register\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRegisters a new domain name and creates a corresponding `Registration` resource.\n\nCall `registrations.retrieveRegisterParameters` first to check availability of the domain name and determine parameters like price that are needed to build a call to this method.\n\nA successful call creates a `Registration` resource in state `REGISTRATION_PENDING`, which resolves to `ACTIVE` within 1-2 minutes, indicating that the domain was successfully registered. If the resource ends up in state `REGISTRATION_FAILED`, it indicates that the domain was not registered successfully, and you can safely delete the resource and retry registration.\n\n### HTTP request\n\n`POST https://domains.googleapis.com/v1/{parent=projects/*/locations/*}/registrations:register`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/domains/docs/reference/rest/Shared.Types/ListOperationsResponse#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/)."]]