Notice: Over the next few months, we're reorganizing the App Engine documentation site to make it easier to find content and better align with the rest of Google Cloud products. The same content will be available, but the navigation will now match the rest of the Cloud products. If you have feedback or questions as you navigate the site, click Send Feedback.

Method: apps.domainMappings.create

Stay organized with collections Save and categorize content based on your preferences.

Maps a domain to an application. A user must be authorized to administer a domain in order to map it to an application. For a list of available authorized domains, see AuthorizedDomains.ListAuthorizedDomains.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Name of the parent Application resource. Example: apps/myapp.

Authorization requires the following IAM permission on the specified resource parent:

  • appengine.applications.update

Query parameters


enum (DomainOverrideStrategy)

Whether the domain creation should override any existing mappings for this domain. By default, overrides are rejected.

Request body

The request body contains an instance of DomainMapping.

Response body

If successful, the response body contains a newly created instance of Operation.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.


Override strategy for mutating an existing mapping.

STRICT Overrides not allowed. If a mapping already exists for the specified domain, the request will return an ALREADY_EXISTS (409).
OVERRIDE Overrides allowed. If a mapping already exists for the specified domain, the request will overwrite it. Note that this might stop another Google product from serving. For example, if the domain is mapped to another App Engine application, that app will no longer serve from that domain.