Ads API •References / ad-accounts / Add a member to an ad account that belongs to a business.

Add a member to an ad account that belongs to a business.

Add a member to 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
A unique identifier for a business member.
Example: "125335bb419b494dbedd31105d56a49a"
rolestring
Required
The role of a user in an ad account.
Allowed values: "AD_ACCOUNT_ADMIN", "AD_ACCOUNT_CONTRIBUTOR", "AD_ACCOUNT_VIEWER"

Response

Metadata of user's permission to an ad account.

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"}