Grant Roles/Domain Permissions, Internal Transfer


With this request you can assign 'Roles' (permissions) of domains to other users. The special role "creator" is an equivalent to an internal transfer of that domain to another user.In this case, the domain is assigned to the receiving account, including all rights and permissions on this domain.

There are two variants to use this functionality: If the user id ( user account id) is given, and the account id matches the associated email address, the role is applied immediately - there will be no request for confirmation on the receiver's side. In case the user id is not given, but only the email address, the transaction has to be acknowledged by the receiver. For this, he will get an email, containing a link and a key. Either the link has to be clicked, or the key has to be applied using (=> Transfer). This can also be used for users which do not yet have a account.

You have to provide the following parameters:

  • domain name (the domain you want to grant somebody else permissions on)
  • destination client email (the email address of the user you want to receive permissions)

The following parameters are optional:

  • destination client id (ID of account - always shown in the upper right on, also conforms to "reseller id" - must match the 'destination client email')
  • desired role (type of permission you want to assign to "client email" resp. "client id" - one of  "admin|tech|billing|creator"; "creator" means "all permissions" and is equivalent to an internal transfer or 'assignment' - also see 'roles ')  

Request fields

mailsubject: joker-internal-transfer [your reference id]

Definition of this request

Valid values for <tld>: all tlds

request-field valid values required
fqdn [a-z0-9-]{1,63}\.<tld>  yes








 admin|tech|billing|creator (if omitted, default is 'creator')



Example 1: assign 'billing'-role to user 123456 (direct)


subject: joker-internal-transfer [your reference id]


Example 2: assign 'creator'-role to user '' (internal transfer with invitation)

subject: joker-internal-transfer [your reference id]


Tags: permissions, roles, transfer, grants

Related entries:

You cannot comment on this entry