Domains Managed: 701212

Pay in € $ £

Access problems? Shopping cart

What is the activation procedure for Gandi API Mail ?

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:

  ------BEGIN PGP PUBLIC KEY BLOCK------
  ------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.

Customer Care

Do you need more information on this topic?, Contact Gandi Customer Care

Error

Have you spotted an error in this answer, or think that it is outdated? You may start a support ticket, and our Customer Care staff will update it as soon as possible.
Note: No support request sent to this e-mail address will be replied to. To contact Customer Care, please use our online form.