---
title: "POST /v23/customers/{customersId}/customerUserAccessInvitations:mutate"
method: POST
path: "/v23/customers/{customersId}/customerUserAccessInvitations:mutate"
tags: ["customers"]
---

# POST /v23/customers/{customersId}/customerUserAccessInvitations:mutate

`POST /v23/customers/{customersId}/customerUserAccessInvitations:mutate`

## Request

- Base URL: `https://searchads360.googleapis.com`
- URL: `https://searchads360.googleapis.com/v23/customers/{customersId}/customerUserAccessInvitations:mutate`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/doubleclicksearch`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/doubleclicksearch`
- TypeScript: <https://skmtc.dev/google/apis/searchads360/docs/v23/customers/:customersId/customerUserAccessInvitations:mutate/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates or removes an access invitation. List of thrown errors: [AccessInvitationError]() [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QuotaError]() [RequestError]()

## Path parameters

- `customersId` string, required

## Request body

- GoogleAdsSearchads360V23ServicesMutateCustomerUserAccessInvitationRequest: Request message for CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation
  - `operation` GoogleAdsSearchads360V23ServicesCustomerUserAccessInvitationOperation: A single operation (create or remove) on customer user access invitation.
    - `create` GoogleAdsSearchads360V23ResourcesCustomerUserAccessInvitation: Represent an invitation to a new user on this customer account.
      - `accessRole` 'UNSPECIFIED' | 'UNKNOWN' | 'ADMIN' | 'STANDARD' | 'READ_ONLY' | 'EMAIL_ONLY': Immutable. Access role of the user.
      - `creationDateTime` string: Output only. Time invitation was created. This field is read-only. The format is "YYYY-MM-DD HH:MM:SS". Examples: "2018-03-05 09:15:00" or "2018-02-01 14:34:30"
      - `emailAddress` string: Immutable. Email address the invitation was sent to. This can differ from the email address of the account that accepts the invite.
      - `invitationId` string, int64: Output only. The ID of the invitation. This field is read-only.
      - `invitationStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'PENDING' | 'DECLINED' | 'EXPIRED': Output only. Invitation status of the user.
      - `resourceName` string: Immutable. Name of the resource. Resource names have the form: `customers/{customer_id}/customerUserAccessInvitations/{invitation_id}`
    - `remove` string: Remove operation: A resource name for the revoke invitation is expected, in this format: `customers/{customer_id}/customerUserAccessInvitations/{invitation_id}`

## Response `200`

Successful response

- GoogleAdsSearchads360V23ServicesMutateCustomerUserAccessInvitationResponse: Response message for access invitation mutate.
  - `result` GoogleAdsSearchads360V23ServicesMutateCustomerUserAccessInvitationResult: The result for the access invitation mutate.
    - `resourceName` string: Returned for successful operations.

---

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