---
title: "POST /v1/locations/{locationsId}/admins"
method: POST
path: "/v1/locations/{locationsId}/admins"
tags: ["locations"]
---

# POST /v1/locations/{locationsId}/admins

`POST /v1/locations/{locationsId}/admins`

## Request

- Base URL: `https://mybusinessaccountmanagement.googleapis.com`
- URL: `https://mybusinessaccountmanagement.googleapis.com/v1/locations/{locationsId}/admins`
- Auth: none declared
- TypeScript: <https://skmtc.dev/google/apis/mybusinessaccountmanagement/docs/v1/locations/:locationsId/admins/post.ts> (a function with typed inputs; its response is checked against the schema)

Invites the specified user to become an administrator for the specified location. The invitee must accept the invitation in order to be granted access to the location. See AcceptInvitation to programmatically accept an invitation.

## Path parameters

- `locationsId` string, required

## Request body

- Admin: An administrator of an Account or a location.
  - `account` string: Immutable. The name of the Account resource that this Admin refers to. Used when calling locations.admins.create to invite a LocationGroup as an admin. If both this field and `admin` are set on `CREATE` requests, this field takes precedence and the email address in `admin` will be ignored. Format: `accounts/{account}`.
  - `admin` string: Optional. The name of the admin. When making the initial invitation, this is the invitee's email address. On `GET` calls, the user's email address is returned if the invitation is still pending. Otherwise, it contains the user's first and last names. This field is only needed to be set during admin creation.
  - `name` string: Immutable. The resource name. For account admins, this is in the form: `accounts/{account_id}/admins/{admin_id}` For location admins, this is in the form: `locations/{location_id}/admins/{admin_id}` This field will be ignored if set during admin creation.
  - `pendingInvitation` boolean: Output only. Indicates whether this admin has a pending invitation for the specified resource.
  - `role` 'ADMIN_ROLE_UNSPECIFIED' | 'PRIMARY_OWNER' | 'OWNER' | 'MANAGER' | 'SITE_MANAGER': Required. Specifies the role that this admin uses with the specified Account or Location.

## Response `200`

Successful response

- Admin: An administrator of an Account or a location.
  - `account` string: Immutable. The name of the Account resource that this Admin refers to. Used when calling locations.admins.create to invite a LocationGroup as an admin. If both this field and `admin` are set on `CREATE` requests, this field takes precedence and the email address in `admin` will be ignored. Format: `accounts/{account}`.
  - `admin` string: Optional. The name of the admin. When making the initial invitation, this is the invitee's email address. On `GET` calls, the user's email address is returned if the invitation is still pending. Otherwise, it contains the user's first and last names. This field is only needed to be set during admin creation.
  - `name` string: Immutable. The resource name. For account admins, this is in the form: `accounts/{account_id}/admins/{admin_id}` For location admins, this is in the form: `locations/{location_id}/admins/{admin_id}` This field will be ignored if set during admin creation.
  - `pendingInvitation` boolean: Output only. Indicates whether this admin has a pending invitation for the specified resource.
  - `role` 'ADMIN_ROLE_UNSPECIFIED' | 'PRIMARY_OWNER' | 'OWNER' | 'MANAGER' | 'SITE_MANAGER': Required. Specifies the role that this admin uses with the specified Account or Location.

---

[API](https://skmtc.dev/google/apis/mybusinessaccountmanagement.md) - [All operations](https://skmtc.dev/google/apis/mybusinessaccountmanagement/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/mybusinessaccountmanagement/revisions/3f94f1e4f01e?raw)