--- title: Add Member --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Accounts](https://developers.cloudflare.com/api/go/resources/accounts) [Members](https://developers.cloudflare.com/api/go/resources/accounts/subresources/members) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Add Member client.Accounts.Members.New(ctx, params) (\*[Member](), error) 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
params MemberNewParams AccountID param.Field\[string] Path param: Account identifier tag. maxLength32 minLength32 Link to this property Email param.Field\[string] Body param: The contact email address of the user. maxLength90 Link to this property Roles param.Field\[\[]string] Body param: Array of roles associated with this member. Link to this property
Status param.Field\[MemberNewParamsIAMCreateMemberWithRolesStatus]Optional Body param: 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. const MemberNewParamsIAMCreateMemberWithRolesStatusAccepted MemberNewParamsIAMCreateMemberWithRolesStatus = "accepted" Link to this property const MemberNewParamsIAMCreateMemberWithRolesStatusPending MemberNewParamsIAMCreateMemberWithRolesStatus = "pending" Link to this property
Link to this property
[Link to this property](<#(resource)%20accounts.members%20%3E%20(method)%20create%20%3E%20(params)%200>) ##### ReturnsExpand Collapse
type Member struct{…} ID stringOptional Membership identifier tag. maxLength32 Link to this property Email stringOptional The contact email address of the user. maxLength90 Link to this property
Policies \[]MemberPolicyOptional Access policy for the membership ID stringOptional Policy identifier. Link to this property
Access MemberPoliciesAccessOptional Allow or deny operations against the resources. One of the following: const MemberPoliciesAccessAllow MemberPoliciesAccess = "allow" Link to this property const MemberPoliciesAccessDeny MemberPoliciesAccess = "deny" Link to this property
Link to this property
PermissionGroups \[]MemberPoliciesPermissionGroupOptional A set of permission groups that are specified to the policy. ID string Identifier of the permission group. Link to this property
Meta MemberPoliciesPermissionGroupsMetaOptional Attributes associated to the permission group. Category stringOptional A category used to group permission groups. Link to this property Deprecated stringOptional Indicates whether the permission group is deprecated. Link to this property Description stringOptional Additional information about the permission group. Link to this property Editable stringOptional Indicates whether the permission group can be edited. Link to this property EolAt TimeOptional The planned end-of-life date and time, when provided. formatdate-time Link to this property Label stringOptional A label identifying the permission group. Link to this property Scopes stringOptional The scope associated with the permission group. Link to this property Visibility stringOptional Indicates the permission group’s availability or visibility. Link to this property
Link to this property Name stringOptional Name of the permission group. Link to this property
Link to this property
ResourceGroups \[]MemberPoliciesResourceGroupOptional A list of resource groups that the policy applies to. ID string Identifier of the resource group. Link to this property
Scope MemberPoliciesResourceGroupsScope A scope is a combination of scope objects which provides additional context. Key string This is a combination of pre-defined resource name and identifier (like Account ID etc.) Link to this property
Objects \[]MemberPoliciesResourceGroupsScopeObject A list of scope objects for additional context. Key string This is a combination of pre-defined resource name and identifier (like Zone ID etc.) Link to this property
Link to this property
Link to this property
Meta MemberPoliciesResourceGroupsMetaOptional Attributes associated to the resource group. Key stringOptional Link to this property Value stringOptional Link to this property
Link to this property Name stringOptional Name of the resource group. Link to this property
Link to this property
Link to this property
Roles \[]RoleOptional Roles assigned to this Member. ID string Role identifier tag. maxLength32 Link to this property Description string Description of role’s permissions. Link to this property Name string Role name. maxLength120 Link to this property
Permissions RolePermissions
Analytics PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Billing PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
CachePurge PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
DNS PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
DNSRecords PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
LB PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Logs PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Organization PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
SSL PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
WAF PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
ZoneSettings PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Zones PermissionGrantOptional Read boolOptional Link to this property Write boolOptional Link to this property
Link to this property
Link to this property
Link to this property
Status MemberStatusOptional A member’s status in the account. One of the following: const MemberStatusAccepted MemberStatus = "accepted" Link to this property const MemberStatusPending MemberStatus = "pending" Link to this property
Link to this property
User MemberUserOptional Details of the user associated to the membership. Email string The contact email address of the user. maxLength90 Link to this property ID stringOptional Identifier maxLength32 minLength32 Link to this property FirstName stringOptional User’s first name maxLength60 Link to this property LastName stringOptional User’s last name maxLength60 Link to this property TwoFactorAuthenticationEnabled boolOptional 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 Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/accounts" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIKey("144c9defac04969c7bfad8efaa8ea194"), option.WithAPIEmail("user@example.com"), ) member, err := client.Accounts.Members.New(context.TODO(), accounts.MemberNewParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), Body: accounts.MemberNewParamsBodyIAMCreateMemberWithRoles{ Email: cloudflare.F("user@example.com"), Roles: cloudflare.F([]string{"3536bcfad5faccb999b47003c79917fb"}), }, }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", 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 } } } ```