Skip to content
Ads API •References / ad-accounts / Update an ad account member's role

Update an ad account member's role

Update a member's role within an ad account.

Request

  • ad_account_idstring [uuid]
    Required

    A unique identifier for an Ad Account.

    Example: ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a
  • member_idstring
    Required
  • rolestring

    The role of a user in an ad account.

    Allowed values: "AD_ACCOUNT_ADMIN", "AD_ACCOUNT_CONTRIBUTOR", "AD_ACCOUNT_VIEWER"

Response

Metadata of a business member.

  • member_idstring

    A unique identifier for a business member.

    Example: "125335bb419b494dbedd31105d56a49a"
  • rolestring

    The role of a user in an ad account.

    Allowed values: "AD_ACCOUNT_ADMIN", "AD_ACCOUNT_CONTRIBUTOR", "AD_ACCOUNT_VIEWER"
  • namestring

    Name given to identify your account.

    Pattern: ^(?!\s).+(?<!\s)$Length between 1 and 120Example: "Account Name"
  • email_addressstring

    The email address of a user in or invited to a business.

    Maximum length: 319Example: "discovery@gmail.com"
  • created_atstring [date-time]

    Date the entity was created. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

    Example: "2026-01-23T04:56:07Z"
  • updated_atstring [date-time]

    Date the entity was updated. Time should be in ISO 8601 format using Coordinated Universal Time (UTC) with a zero offset: YYYY-MM-DDTHH:MM:SSZ

    Example: "2026-01-23T04:56:07Z"
  • ad_account_idstring [uuid]

    A unique identifier for the entity.

    Example: "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"

Response sample

{  "member_id": "125335bb419b494dbedd31105d56a49a",  "role": "AD_ACCOUNT_ADMIN",  "name": "Account Name",  "email_address": "discovery@gmail.com",  "created_at": "2026-01-23T04:56:07Z",  "updated_at": "2026-01-23T04:56:07Z",  "ad_account_id": "ce4ff15e-f04d-48b9-9ddf-fb3c85fbd57a"}