Ads and Commerce

System User

Updated: Aug 4, 2022
Copy for LLM
Ads in WhatsApp Status are available via the Marketing API. Learn more about ads in WhatsApp Status.

Reading

Represents a system user

Example

GET /v25.0/{system-user-id} HTTP/1.1
Host: graph.facebook.com
Try it in Graph API Explorer
If you want to learn how to use the Graph API, read our Using Graph API guide

Parameters

This endpoint doesn't have any parameters.

Fields

Field Description
id
numeric string
System user ID.

default
created_by
User
The creator of this system user.
created_time
datetime
The creation time of this system user.
finance_permission
string
Financial permission role of the user in business manager, such as Editor, Analyst, and so on.
ip_permission
string
Ads right permission role of the user in business manager, such as Reviewer, and so on.
name
string
Name used to identify this system user.

default

Edges

Edge Description
assigned_business_asset_groups
Edge<BusinessAssetGroup>
Business asset groups that are assign to this business scoped user
assigned_pages
Edge<Page>
Pages that are assigned to this business scoped user
assigned_product_catalogs
Edge<ProductCatalog>
Product catalogs that are assigned to this business scoped user
assigned_whatsapp_business_accounts
Edge<WhatsAppBusinessAccount>
WhatsApp business accounts that are assigned to the business user

Error Codes

Error Code Description
100
Invalid parameter
110
Invalid user id

Creating

/{business_id}/system_users

You can make a POST request to system_users edge from the following paths:
When posting to this edge, a SystemUser will be created.

Parameters

Parameter Description
name
string
Name of system user to be added to this business.
required
role
enum {FINANCE_EDITOR, FINANCE_ANALYST, ADS_RIGHTS_REVIEWER, ADMIN, EMPLOYEE, DEVELOPER, PARTNER_CENTER_ADMIN, PARTNER_CENTER_ANALYST, PARTNER_CENTER_OPERATIONS, PARTNER_CENTER_MARKETING, PARTNER_CENTER_EDUCATION, MANAGE, DEFAULT, FINANCE_EDIT, FINANCE_VIEW}
Role of system user to be added to this business.
system_user_id
int
ID of system user.

Return Type

This endpoint supports read-after-write and will read the node represented by id in the return type. 
Struct  {
id: numeric string,
}

Error Codes

Error Code Description
104001
In order to create a system user, an app must be part of this business. Please add an app and then try again.
100
Invalid parameter
3949
This Business Manager has reached maximum number of system user limit.
3965
This Business Manager has reached maximum number of admin system user limit.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.