Last month we discussed how to 
create headers and footers using the new API function addHeaderFooters, instead of logging into the Bronto application. To help our Agency accounts, we have also introduced the function addAccounts that allows you to create an agency client account without logging into Bronto.
The new function and its related functions deleteAccounts, readAccounts and updateAccounts allows you to maintain your client accounts from outside the Bronto application. The arguments for this function fall into generalSettings, contactInformation, formatSettings, brandingSettings, repliesSettings and allocations. You can use these new functions to integrate Bronto into an external application where you preform other work, there by cutting down on the time you spend switching between applications. To do this you would need to generate a SOAP message like this:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v4="http://api.bronto.com/v4">
<soapenv:Header>
<v4:sessionHeader>
<sessionId>79811a0f-xxxx-xxxx-xxxx-3c495d1bdbee</sessionId>
</v4:sessionHeader>
</soapenv:Header>
<soapenv:Body>
<v4:addAccounts>
<accounts><name>AddTestAccount</name>
<generalSettings>
<siteName>subaccount_test_account</siteName>
<emergencyEmail>example@bronto.com</emergencyEmail>
<bounceLimit>5</bounceLimit>
<dailyFrequencyCap>5</dailyFrequencyCap>
<weeklyFrequencyCap>5</weeklyFrequencyCap>
<monthlyFrequencyCap>5</monthlyFrequencyCap>
<textDelivery>1</textDelivery>
<textPreference>1</textPreference>
<useSSL>1</useSSL>
<currentContacts>0</currentContacts>
<maxContacts>10000</maxContacts>
<currentMonthlyEmails>10000</currentMonthlyEmails>
<currentHostingSize>10</currentHostingSize>
<maxHostingSize>10</maxHostingSize>
</generalSettings>
<contactInformation>
<organization>organization name</organization>
<firstName>first name</firstName>
<lastName>last name</lastName>
<email>example@bronto.com</email>
<phone>phone</phone>
<address>address</address>
<address2>address2</address2>
<city>city</city>
<state>state</state>
<zip>zip</zip>
<country>country</country>
<notes>notes here</notes>
</contactInformation>
<allocation>
<startDate>2010-05-10T19:20:30-05:00</startDate>
<periodFrequency>12></periodFrequency>
<emails>10000</emails>
<api>false</api>
<bundle>intermediate</bundle>
</allocation>
<formatSettings>
</formatSettings>
<brandingSettings>
</brandindSettings>
<repliesSettings>
</repliesSettings>
</accounts>
</v4:addAccounts>
</soapenv:Body>
</soapenv:Envelope>
Of course, after you create your client accounts, you can do a readAccounts to display information about those clients accounts in another application. Then using updateAccounts, you can update a client account and maintain it without having to switch over to Bronto. You could also set up an automatic system to examine your client accounts on a regular basis and alert you if any are approaching a limit, such as maximum number of contacts allowed in the current allocation period.
If you have any questions, feel free to leave them in the comments section below.
Andrew Kanes
Support Engineer at Bronto
Related posts:
- May I Have Another User As part of version 4 of the Bronto API, we...
- Token, Token, Who Wants a Token? Another new feature of version 4 of the Bronto API...
- Create a Header Without Logging into Bronto Did you know you can now create headers and footers...
Follow Bronto on Twitter
{ 2 trackbacks }
{ 0 comments… add one now }