Resello REST API Documentation

POST customer

Creates a new customer.

Resource URL

https://backoffice.hostcontrol.com/api/v1/customer

Parameters

Parameter Required? Description Example value
organisation optional Name of the organisation. Company Inc.
name required Name of the customer. John Doe
gender optional Gender of the customer. male
address required Address of the customer. Street 123
zipcode required Zipcode of the customer. 1234AA
city required City of the customer. Groningen
country required Short code of the country of the customer. NL
state optional State of the customer. If the country has states, this is parameter becomes required to fill in. Groningen
email required Email address of the customer. The email address has to be unique. john@doe-inc.com
voice required Telephone number of the customer. +31.612345678
fax optional Fax number of the customer. +31.123456789
vat_number optional VAT number of the customer. NL001234567B01
registration_ip required The IP address of the customer. 212.51.12.34
password required Password of the customer. the-desired-password

Example request


POST    https://backoffice.hostcontrol.com/api/v1/customer

POST Data

{
    "name": "John Doe",
    "address": "Street 123",
    "zipcode": "1234AA",
    "city": "Groningen",
    "country": "NL",
    "state": "Groningen",
    "email": "john@doe-inc.com",
    "voice": "+31.612345678",
    "registration_ip": "192.168.0.101",
    "password": "the-desired-password"
}

Result

{
    "result": {
        "is_enabled": true,
        "updated": "2013-10-22T11:41:01.578064+00:00",
        "is_dns_management_enabled": true,
        "created": "2013-10-22T11:41:01.578022+00:00",
        "primary_contact": {
            "city": "Groningen",
            "fax": "",
            "voice": "+31.612345678",
            "updated": "2013-10-22T11:41:01.584887+00:00",
            "name": "John Doe",
            "created": "2013-10-22T11:41:01.584844+00:00",
            "gender": null,
            "organisation": "",
            "extra": {},
            "zipcode": "1234AA",
            "email": "john@doe-inc.com",
            "state": "Groningen",
            "address": "Street 123",
            "domains": [],
            "vat_number": null,
            "country": {
                "code": "NL",
                "name": "Netherlands"
            },
            "type": "primary",
            "id": 54
        },
        "is_receiving_support_notifications": true,
        "is_ns_management_enabled": true,
        "is_verified": true,
        "id": 34
    },
    "success": true
}