If you want to register a large quantity of domain names on a regular basis (at least 20 domains upon the opening of your account), our system of ordering domains by e-mail will simplify matters. Once you have activated the email API on your Reseller account, you may use it for all your domain name operations (creations, transfers, or renewals) by using an interface based on e-mail.

NOTE : For subsequent changes to the domain names, you must go through the web interface.

You may register as many domain names by e-mail as your credit allows. Your e-mail order must use the correct syntax, be signed as PGP (without MIME files), and be sent to our automated server, secure@gandi.net.You will receive two automated replies:

• An immediate response, indicating that the syntax of your request is correct ("queuing domain for…") or incorrect ("error…")
• Later, you will be sent an e-mail at the address you indicated during the creation of your account that indicates the result of your request.

Your e-mail will only be read by a computer: you must therefore take care to use the correct syntax for each type of operation. Each line of your e-mail must contain a pair (key, attribute), separated by a colon (:), as follows: key:value This pair (key:value) defines the following elements:

• Your handle as reseller
• Nature of the operation (by default it is a creation)
• Owner type (individual, company…)
• Gandi handle and the details of each contact (owner, admin, tech, billing)
• List of domains to be processed
• List of nameservers for the domains

• An interface that is adapted to the registration of a large number of domains : one e-mail suffices for the registration of 10 domains
• Faster processing time for transfers (except .fr): you can reduce the delay of acceptance by the contacts (5 days).

• The minimum amount of each payment to the prepaid account is 120 Euros Excl. VAT
• in order to correctly sign your e-mails, you must either know how to use PGP, or be able to teach yourself how to use it

To purchase a domain name by e-mail, once your professional account has been created and is activated, you must send us a PGP (short for Pretty Good Privacy) signed e-mail to our automated address, secure@gandi.net, with the key that you have registered with your account. All the fields that can be used are available for viewing at the page, "Syntax Summary".

Below is an example of the correct syntax for the creation of 2 domains:

action:creation   <= type of operation
reseller_handle: AB18-GANDI  <= required
owner_handle:new_handle  <= to create a new owner
owner_type: individual   <= individual or company
owner_organization:Supercompany ets  <= company name
owner_firstname: John
owner_lastname: Doe 
owner_brand:12162099 <=for .FR domains owned by association
owner_siret:123456789  <= for .FR domains owned by companies
owner_birthdep: 75  <= for .FR domains owned by individuals
owner_birthcity: Arras  <= for .FR owned by individuals
owner_birthdate: 1976/03/06  <= for .FR owned by individuals
owner_birthcountry: FR  <=for .FR owned by individuals
owner_address-1:1701 Fairchild Avenue
owner_city:Iowa City
owner_state:Iowa<= if relevant
owner_postal-code:52245
owner_country:US   <= 2-letter ISO country code
owner_email:johndoe@example.com
owner_phone:+1.5551231234<= international format
owner_fax:+1.5551231234

tech_handle:AR41-GANDI   <= here we use an existing Gandi handle

admin_handle: same_as_billing  <=  this command is also possible

billing_handle:new_handle  <=  command to make a new Gandi handle
bl_name: John Doe
bl_address-1:1701 Fairchild Avenue
bl_postal-code:52245
bl_city:Iowa City
bl_owner_state:Iowa
bl_country:US
bl_phone:+1.5551231234
bl_fax:+1.5551231234
bl_email:johndoe@example.com
bl_password:123456

domains0:mydomain.com  <= domain(s) to be purchased with these settings
domains1: myseconddomain.net
...
domains9: myninthdomain.net<= you may specify up to 10 domains

ns0-domain-name:a.dns.gandi.nett  <= primary DNS for the above domains
ns0-ip-address:  217.70.179.40<= IP address of the primary DNS
ns1-domain-name:b.dns.gandi.net <= secondary DNS 
ns1-ip-address: 217.70.184.40
ns2-domain-name:c.dns.gandi.net <= you may specify from 3 to 6 servers
ns-ip-address: 217.70.182.20

If the syntax of your e-mail is correct, you will receive a confirmation e-mail saying that your order is being processed. This e-mail will resemble the following:

 NOTICE: any use of a production account implies acceptance of
our domain contract. See:
http://www.gandi.net/contracts

Mail signed with keyid XXXXX.

Account information for keyid XXXX before processing:
	You have XX.XX Euros left in your account.
THESE COUNTS DO NOT INCLUDE DOMAINS PROCESSED BELOW.

Handle for owner contact is JD12345-GANDI
andle for reseller contact is AB1888-GANDI
Handle for admin contact is JD12346-GANDI
Handle for tech contact is AR41-GANDI
andle for billing contact is JD12346-GANDI

Queuing domain mondomaine.com for creation.
Queuing domain monautredomaine.net for creation.

End of processing.

Here is an example of an order to transfer a domain name via the e-mail order system. There is a list of all the possible command lines that may be used on the page: "Command Summary".

action:transfer

reseller_handle:AR41-GANDI

owner_organization:John Doe
owner_address-1:1701 Fairchild Avenue
owner_city:Iowa City
owner_state:Iowa
owner_postal-code:52245
owner_country:US

admin_handle:AR41-GANDI
tech_handle: same_as_admin
billing_handle:same_as_admin

domains0:mydomain.com
eppkey0:epp authorization key
domains1: myotherdomain.net
eppkey1:1245214521  <= mandatory except for .eu .be .fr domains

Before using the API for transfers, you must contact our Customer Care Department so that we can set up your account.

Here is an example of an order to renew a domain name via the e-mail ordering system. There is a list of all the command lines possible at the following page: "Command Summary".

action:renew
reseller_handle: AB18-GANDI  <= required 
period:2  <= number of years that you want to renew for 
current_year:2006 <= not mandatory but recommended, to avoid doubles
domains0:mydomain.com
domains1:myotherdomain.net

You can activate API Mail in the Account section of our website (Manage Area). This will allow you to order domain name registrations, renewals and transfers via PGP-signed e-mail.

For more information on using this tool, please refer to the corresponding FAQ.

Here are the five steps necessary for setting-up and using your API Mail account:

• Reseller Account: verify beforehand that your handle is a 'reseller'-type account. If this is not the case, you may convert your normal account into a reseller account.

• Creation of a PGP key: if you do not already have one, please create a PGP or GPG key at this time.

PGP is a commonly-used system for the verification and encryption of data. We do not provide technical assistance in the use of PGP, although you will find a wealth of information and tools online: the GPG website (a freeware application); PGP websites such as pgp.com or pgpi.com; Thunderbird's PGP plugin, Enigmail, to add PGP to your mail client if you use the free Mozilla Thunderbird program for your e-mails.

• Mail Gandi your key: send your public GPG or PGP key to us at keys@gandi.net . When doing so, please include your unencrypted key in the body of the message, and do not remove the following tags:

1. —–BEGIN PGP PUBLIC KEY BLOCK——
2. —–END PGP PUBLIC KEY BLOCK——

The mail's subject should be the command, ADD. Additionally, the mail must be sent in ASCII plain text.

Please do not send a key that uses the IDEA algorithm, as our system uses the GPG open-sourse program that is incompatible with that algorithm. Also, be sure that you are not using attached PGP/MIME files like those that are generated by the majority of modern e-mail clients (not BASE 64 or Quoted Printable), this will cause the verification of your e-mail to fail.

• Link your key to your reseller account: in your Reseller Options, activate API Mail, and add your key.

• Credit your prepaid account: verify that you have an active prepaid account with sufficient credit in order to process your order.

We have provided a list of commands that are used to order via e-mail in our FAQ, such as how to create, transfer, and renew domains, in addition to a summary of all the commands possible.

If you want to dive right in and make your first domain name registration via API mail, here is an example of an order:

reseller_handle:to-be-specified-GANDI
owner_handle:new_handle
owner_type: individual
owner_organization:first and last name, or name of the company
owner_firstname:first name
owner_lastname:last name
owner_address-1:to-be-specified
owner_city:to-be-specified
owner_postal-code:to-be-specified
owner_country:FR owner_email:to-be-specified
owner_phone:to-be-specified
owner_fax:to-be-specified
admin_handle:to-be-specified-GANDI
tech_handle:to-be-specified-GANDI
billing_handle:to-be-specified-GANDI
domains0:domain name to create
domains1:another domain name to create
ns0-domain-name:a.dns.gandi.net
ns0-ip-address:217.70.179.40
ns1-domain-name:b.dns.gandi.net
ns1-ip-address:217.70.184.40
ns2-domain-name:c.dns.gandi.net
ns2-ip-address:217.70.182.20

You have the possibility of encrypting your orders with our public key. We advise that you encrypt each e-mail that includes the password of a contact.

http://en.gandi.net/faq/view_question/en/6/what_are_the_main_command_lines_for_e-mail_orders