Adds a list of name and email addresses to your address book.
Client Servlet | Server Servlet | HTTP Methods Supported | Requires Authentication |
---|---|---|---|
CRAddressBookAPI | None. | GET, POST | Yes. |
See topic Common Parameters.
Required. Comma-separated list of names and addresses. e.g. "Bob Smith" <bob@example.com>, "Kelly Smith" <kelly@example.com>
Type xsd:string.
Optional. You must provide either this parameter or the sso_auth_token parameter. If using this parameter, you must specify an auth token generated by an embedded [[S86]] session tag in a Convio web page.
Optional. You must provide either this parameter or the auth parameter. If using this parameter, you must specify a valid session authentication token returned by login, authenticateUser, or getSingleSignOnToken.
See topic HTTP Status Codes.
XML response<?xml version="1.0" encoding="UTF-8"?> <getAddressBookContactsResponse xsi:schemaLocation="http://convio.com/crm/v1.0 http://service.convio.net/xmlschema/crm.public.v1.xsd" xmlns="http://convio.com/crm/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <addressBookContact> <id>100</id> <firstName>User0First</firstName> <lastName>User0Last</lastName> <email>user0@example.com</email> <group> <id>200</id> <name>Group 0</name> </group> <group> <id>200</id> <name>Group 0</name> </group> </addressBookContact> <addressBookContact> <id>101</id> <firstName>User1First</firstName> <lastName>User1Last</lastName> <email>user1@example.com</email> <group> <id>201</id> <name>Group 1</name> </group> </addressBookContact> </getAddressBookContactsResponse>JSON response
{"getAddressBookContactsResponse":{"addressBookContact":[{"id":"100","lastName":"User0Last","email":"user0@example.com","group":[{"id":"200","name":"Group 0"},{"id":"200","name":"Group 0"}],"firstName":"User0First"},{"id":"101","lastName":"User1Last","email":"user1@example.com","group":{"id":"201","name":"Group 1"},"firstName":"User1First"}]}}