Method: accounts.icons.create

Uploads a new icon and starts its review process. Generates an icon_id and includes it in the icon's resource name, which is the format accounts/{account_id}/icons/{icon_id}

Returns HTTP status 400 and doesn't trigger the review process if the icon has any of these conditions:

  • Image is not in PNG format, or not convertible to PNG format.
  • Size less than 72 pixels
  • Size greater than 1200 pixels
  • Aspect ratio other than 1:1

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The resource name of the partner account owning the icon. The format is accounts/{account_id}.

Request body

The request body contains an instance of Icon.

Response body

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

Authorization scopes

Requires the following OAuth scope:


For more information, see the OAuth 2.0 Overview.