Web Service Documentation / Categories / Basic Account Services / Create Customer
Updated on August 25, 2019
This web service creates an account for a customer based on the information provided in the XML request and establishes a connection to your account. It returns the unique identifier to the newly created account and a link to the corresponding web service to retrieve it.
After creating a new Portfolio Manager account for your customer, you may want to provide them their user account information (i.e., username, password, security questions, etc.). If you decide to provide them this information, you will have to securely communicate this information to your customer on your own. None of the Portfolio Manager web services will transmit this user information to your customer for you.
23.0
POST
/customer
Field Name | Value | Comments |
---|---|---|
Authorization | Basic credentials | |
Content-Type | application/xml |
Yes
None
Request/Response | Schema Name |
---|---|
Request | account.xsd |
Response | response.xsd |
The following example creates a customer account.
POST /customer<?xml version="1.0" encoding="UTF-8"?> <account> <username>acme_customer</username> <password>PA$sw0r6</password> <webserviceUser>true</webserviceUser> <searchable>false</searchable> <billboardMetric>score</billboardMetric> <contact> <firstName>Jack</firstName> <lastName>Brown</lastName> <address address1="123 South St" city="Arlington" state="VA" postalCode="22201" country="US"/> <email>jack_brown@acme.com</email> <jobTitle>Building Administrator Data Exchange User</jobTitle> <phone>703-555-2121</phone> </contact> <organization name="ACME Corporation"> <primaryBusiness>Other</primaryBusiness> <otherBusinessDescription>other</otherBusinessDescription> <energyStarPartner>true</energyStarPartner> <energyStarPartnerType>Service and Product Providers</energyStarPartnerType> </organization> </account>
The following example creates a customer account. If the customer account belongs to Canada, an email preference setting (emailPreferenceCanadianAccount) can also be included which indicates whether the account can receive ENERGY STAR information from the Natural Resources of Canada (NRCAN).
POST /customer<?xml version="1.0" encoding="UTF-8"?> <account> <username>acme_customer</username> <password>PA$sw0r6</password> <webserviceUser>true</webserviceUser> <searchable>false</searchable> <billboardMetric>score</billboardMetric> <contact> <firstName>Jack</firstName> <lastName>Brown</lastName> <address address1="123 South St" city="Edmonton" state="AB" postalCode="T5G 2S7" country="CA"/> <email>jack_brown@acme.com</email> <jobTitle>Building Administrator Data Exchange User</jobTitle> <phone>703-555-2121</phone> </contact> <organization name="ACME Corporation"> <primaryBusiness>Other</primaryBusiness> <otherBusinessDescription>other</otherBusinessDescription> <energyStarPartner>true</energyStarPartner> <energyStarPartnerType>Service and Product Providers</energyStarPartnerType> </organization> <emailPreferenceCanadianAccount>true</emailPreferenceCanadianAccount> </account>
The following example indicates that the customer account was successfully created.
<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
<id>23421</id>
<links>
<link httpMethod="GET" link="/customer/23421" linkDescription="This is the GET url for this Customer."/>
</links>
</response>