Legacy Google+ APIs have been shut down as of March 7, 2019. Changes to the shutdown plan have been made recently which may mitigate its effect on some developers. Learn more.

Google+ integrations for web and mobile apps have also stopped functioning as of March 7, 2019. Learn more.

Circles: addPeople

Requires authorization

Add a person to a circle. Google+ limits certain circle operations, including the number of circle adds. Learn More. Try it now.


HTTP request

PUT https://www.googleapis.com/plusDomains/v1/circles/circleId/people


Parameter name Value Description
Required parameters
circleId string The ID of the circle to add the person to.
Optional parameters
email string Email of the people to add to the circle. Optional, can be repeated.
userId string IDs of the people to add to the circle. Optional, can be repeated.


To learn when scopes are required, see Google+ Domains scopes.


Request body

Do not supply a request body with this method.


If successful, this method returns a circle resource in the response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer.

Send feedback about...

Google+ Domains API
Google+ Domains API