Update to GetContacts API Call
You can now specify a Page Size (pagingsize) to limit the number of contacts that are returned to you in the results. This helps reduce the time it takes to get your first results, as well as lessen the chance of getting a server time out from us, or on your own server.
For subsequent calls, you would then set the Paging Offset (pagingoffset) to the number of records to skip for that call. If your pagingsize was 100, you’d set the offset to 0 on the first call, 100 on the second call, and 200 on the third call… and so on.
We recommend a Paging Size of 500 to 1000 records to begin with.
A default Paging Size for GetContacts will be enforced at a future date, so it’s best to develop assuming it’s in place now.
For those API calls that allow you to search contacts by ID or Email, you can now search by Other Email as well.
New identifymethod Option “3” will search both Contact Email and Contact Other Email, in following API functions:
The contact field OtherSystemID can be used to track and link contacts that are already in another database.
We’ve just added the ability to set this field during AddContact, as well as the ability to look up a contact by this field in GetContacts.
This update will be available when you have a build date of 6/30 or greater.
We’ve just made using the API a whole lot easier.
In the past, you had to know your user’s API Key in order to call functions related to their account. Now, instead of passing their API Key, you can override and use your master apiusername and apipassword instead. This means you can ditch having to keep and store your user’s API Key.
For any API Function that requires the user’s apikey, leave out the apikey field and instead add the apiusername and apipassword fields. (To clarify: These are your master API credentials, not the user’s details)
This option is available now.
The API function GetActivityLog now includes the option to show user logins in the report.
This will be available once you’ve received an update of 6/20/2017 or later.
You can now pin a new contact note via the API. Also, we added the ability to enter a “new line” character in the note. Please see the updated documentation for details. AddContactNote
You will have this in the next update, once your installed version is 4/26/2017 or later.
Good news! We’ve gone back and updated all older API functions to include the option to return the result data as JSON or XML data. XML was the only option for the API functions created in the past.
If you still want XML results, you don’t need to do anything. All results default to XML. If you want your results in JSON, add the field “response_type” to your request fields and set the value to “json”.
You can choose whichever format is easiest to consume in your favorite programming language.
You can now limit the number of contacts in each account. This is useful when you want to have different service level plans for your customers, and restrict the number of contacts on an account by account basis.
See the new “maxcontacts” field in the SetAccountFeatures API function.
Here is a summary of new and updated API functions over the last few months:
New API Functions
GetOptInStatusList : Returns the full list of opt in status results for all email addresses in an accounts database.
GetActivityLog : Returns details from the “Activity Log” report
GetPermissions & SetPermissions : Allows for setting and listing team member permissions
Added fields Inactive, OtherEmail, OtherSystemID to GetContacts function
Added option to return group information about all accounts
New Functions: AddSource, AddCategory2
You now have the ability to add Sources and Category2s via the API
UPDATE: More New Functions: GetLetterTemplate, GetLetterTemplates, UpdateCustomFields
GetLetterTemplate (get details on a specific Letter template)
GetLetterTemplates (get a list of Letter Templates)
UpdateCustomFields (update Custom Fields)
These updates will be available in the next update, when your version timestamp is later than 4/27/2016 (version timestamp is located on home page of the admin page)