--- title: Add Member --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Accounts](https://developers.cloudflare.com/api/python/resources/accounts) [Members](https://developers.cloudflare.com/api/python/resources/accounts/subresources/members) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Add Member accounts.members.create(MemberCreateParams\*\*kwargs) -> [Member]() POST/accounts/{account\_id}/members Add a user to the list of members for this account. ##### Security API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**`X-Auth-Email: user@example.com` The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**`X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194` ##### Accepted Permissions (at least one required) `SCIM Provisioning``Account Settings Write` ##### ParametersExpand Collapse account\_id: str Account identifier tag. maxLength32 minLength32 [Link to this property](<#(resource)%20accounts.members%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20account_id%20%3E%20(schema)>) email: str The contact email address of the user. maxLength90 [Link to this property](<#(resource)%20accounts.members%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20email%20%3E%20(schema)>) roles: Sequence\[str] Array of roles associated with this member. [Link to this property](<#(resource)%20accounts.members%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20roles%20%3E%20(schema)>)

status: Optional\[Literal\["accepted", "pending"]] Status of the member invitation. If not provided during creation, defaults to ‘pending’. Changing from ‘accepted’ back to ‘pending’ will trigger a replacement of the member resource in Terraform.

One of the following: "accepted" Link to this property "pending" Link to this property

[Link to this property](<#(resource)%20accounts.members%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20status%20%3E%20(schema)>) ##### ReturnsExpand Collapse

class Member: …

id: Optional\[str] Membership identifier tag. maxLength32 Link to this property email: Optional\[str] The contact email address of the user. maxLength90 Link to this property

policies: Optional\[List\[Policy]] Access policy for the membership

id: Optional\[str] Policy identifier. Link to this property

access: Optional\[Literal\["allow", "deny"]] Allow or deny operations against the resources.

One of the following: "allow" Link to this property "deny" Link to this property

Link to this property

permission\_groups: Optional\[List\[PolicyPermissionGroup]] A set of permission groups that are specified to the policy.

id: str Identifier of the permission group. Link to this property

meta: Optional\[PolicyPermissionGroupMeta] Attributes associated to the permission group.

category: Optional\[str] A category used to group permission groups. Link to this property deprecated: Optional\[str] Indicates whether the permission group is deprecated. Link to this property description: Optional\[str] Additional information about the permission group. Link to this property editable: Optional\[str] Indicates whether the permission group can be edited. Link to this property eol\_at: Optional\[datetime] The planned end-of-life date and time, when provided. formatdate-time Link to this property label: Optional\[str] A label identifying the permission group. Link to this property scopes: Optional\[str] The scope associated with the permission group. Link to this property visibility: Optional\[str] Indicates the permission group’s availability or visibility. Link to this property

Link to this property name: Optional\[str] Name of the permission group. Link to this property

Link to this property

resource\_groups: Optional\[List\[PolicyResourceGroup]] A list of resource groups that the policy applies to.

id: str Identifier of the resource group. Link to this property

scope: PolicyResourceGroupScope A scope is a combination of scope objects which provides additional context.

key: str This is a combination of pre-defined resource name and identifier (like Account ID etc.) Link to this property

objects: List\[PolicyResourceGroupScopeObject] A list of scope objects for additional context.

key: str This is a combination of pre-defined resource name and identifier (like Zone ID etc.) Link to this property

Link to this property

meta: Optional\[PolicyResourceGroupMeta] Attributes associated to the resource group.

key: Optional\[str] Link to this property value: Optional\[str] Link to this property

Link to this property name: Optional\[str] Name of the resource group. Link to this property

Link to this property

roles: Optional\[List\[Role]] Roles assigned to this Member.

id: str Role identifier tag. maxLength32 Link to this property description: str Description of role’s permissions. Link to this property name: str Role name. maxLength120 Link to this property

permissions: Permissions

analytics: Optional\[PermissionGrant]

read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property

Link to this property

billing: Optional\[PermissionGrant]

read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property

Link to this property

cache\_purge: Optional\[PermissionGrant]

read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property

Link to this property

dns: Optional\[PermissionGrant]

read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property

Link to this property

dns\_records: Optional\[PermissionGrant]

read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property

Link to this property

lb: Optional\[PermissionGrant]

read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property

Link to this property

logs: Optional\[PermissionGrant]

read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property

Link to this property

organization: Optional\[PermissionGrant]

read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property

Link to this property

ssl: Optional\[PermissionGrant]

read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property

Link to this property

waf: Optional\[PermissionGrant]

read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property

Link to this property

zone\_settings: Optional\[PermissionGrant]

read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property

Link to this property

zones: Optional\[PermissionGrant]

read: Optional\[bool] Link to this property write: Optional\[bool] Link to this property

Link to this property

status: Optional\[Literal\["accepted", "pending"]] A member’s status in the account.

One of the following: "accepted" Link to this property "pending" Link to this property

Link to this property

user: Optional\[User] Details of the user associated to the membership.

email: str The contact email address of the user. maxLength90 Link to this property id: Optional\[str] Identifier maxLength32 minLength32 Link to this property first\_name: Optional\[str] User’s first name maxLength60 Link to this property last\_name: Optional\[str] User’s last name maxLength60 Link to this property two\_factor\_authentication\_enabled: Optional\[bool] Indicates whether two-factor authentication is enabled for the user account. Does not apply to API authentication. Link to this property

Link to this property

[Link to this property](<#(resource)%20%24shared%20%3E%20(model)%20member%20%3E%20(schema)>) ### Add Member Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_email=os.environ.get("CLOUDFLARE_EMAIL"), # This is the default and can be omitted api_key=os.environ.get("CLOUDFLARE_API_KEY"), # This is the default and can be omitted ) member = client.accounts.members.create( account_id="023e105f4ecef8ad9ca31a8372d0c353", email="user@example.com", roles=["3536bcfad5faccb999b47003c79917fb"], ) print(member.id) ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "4536bcfad5faccb111b47003c79917fa", "email": "user@example.com", "policies": [ { "id": "f267e341f3dd4697bd3b9f71dd96247f", "access": "allow", "permission_groups": [ { "id": "c8fed203ed3043cba015a93ad1616f1f", "meta": { "category": "category", "deprecated": "deprecated", "description": "description", "editable": "editable", "eol_at": "2019-12-27T18:11:19.117Z", "label": "load_balancer_admin", "scopes": "com.cloudflare.api.account", "visibility": "visibility" }, "name": "Zone Read" }, { "id": "82e64a83756745bbbb1c9c2701bf816b", "meta": { "category": "category", "deprecated": "deprecated", "description": "description", "editable": "editable", "eol_at": "2019-12-27T18:11:19.117Z", "label": "fbm_user", "scopes": "com.cloudflare.api.account", "visibility": "visibility" }, "name": "Magic Network Monitoring" } ], "resource_groups": [ { "id": "6d7f2f5f5b1d4a0e9081fdc98d432fd1", "scope": { "key": "com.cloudflare.api.account.eb78d65290b24279ba6f44721b3ea3c4", "objects": [ { "key": "com.cloudflare.api.account.zone.23f8d65290b24279ba6f44721b3eaad5" } ] }, "meta": { "key": "key", "value": "value" }, "name": "com.cloudflare.api.account.eb78d65290b24279ba6f44721b3ea3c4" } ] } ], "roles": [ { "id": "3536bcfad5faccb999b47003c79917fb", "description": "Administrative access to the entire Account", "name": "Account Administrator", "permissions": { "analytics": { "read": true, "write": false }, "billing": { "read": true, "write": false }, "cache_purge": { "read": true, "write": false }, "dns": { "read": true, "write": false }, "dns_records": { "read": true, "write": false }, "lb": { "read": true, "write": false }, "logs": { "read": true, "write": false }, "organization": { "read": true, "write": false }, "ssl": { "read": true, "write": false }, "waf": { "read": true, "write": false }, "zone_settings": { "read": true, "write": false }, "zones": { "read": true, "write": true } } } ], "status": "accepted", "user": { "email": "user@example.com", "id": "023e105f4ecef8ad9ca31a8372d0c353", "first_name": "John", "last_name": "Appleseed", "two_factor_authentication_enabled": true } } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "4536bcfad5faccb111b47003c79917fa", "email": "user@example.com", "policies": [ { "id": "f267e341f3dd4697bd3b9f71dd96247f", "access": "allow", "permission_groups": [ { "id": "c8fed203ed3043cba015a93ad1616f1f", "meta": { "category": "category", "deprecated": "deprecated", "description": "description", "editable": "editable", "eol_at": "2019-12-27T18:11:19.117Z", "label": "load_balancer_admin", "scopes": "com.cloudflare.api.account", "visibility": "visibility" }, "name": "Zone Read" }, { "id": "82e64a83756745bbbb1c9c2701bf816b", "meta": { "category": "category", "deprecated": "deprecated", "description": "description", "editable": "editable", "eol_at": "2019-12-27T18:11:19.117Z", "label": "fbm_user", "scopes": "com.cloudflare.api.account", "visibility": "visibility" }, "name": "Magic Network Monitoring" } ], "resource_groups": [ { "id": "6d7f2f5f5b1d4a0e9081fdc98d432fd1", "scope": { "key": "com.cloudflare.api.account.eb78d65290b24279ba6f44721b3ea3c4", "objects": [ { "key": "com.cloudflare.api.account.zone.23f8d65290b24279ba6f44721b3eaad5" } ] }, "meta": { "key": "key", "value": "value" }, "name": "com.cloudflare.api.account.eb78d65290b24279ba6f44721b3ea3c4" } ] } ], "roles": [ { "id": "3536bcfad5faccb999b47003c79917fb", "description": "Administrative access to the entire Account", "name": "Account Administrator", "permissions": { "analytics": { "read": true, "write": false }, "billing": { "read": true, "write": false }, "cache_purge": { "read": true, "write": false }, "dns": { "read": true, "write": false }, "dns_records": { "read": true, "write": false }, "lb": { "read": true, "write": false }, "logs": { "read": true, "write": false }, "organization": { "read": true, "write": false }, "ssl": { "read": true, "write": false }, "waf": { "read": true, "write": false }, "zone_settings": { "read": true, "write": false }, "zones": { "read": true, "write": true } } } ], "status": "accepted", "user": { "email": "user@example.com", "id": "023e105f4ecef8ad9ca31a8372d0c353", "first_name": "John", "last_name": "Appleseed", "two_factor_authentication_enabled": true } } } ```