API & Webhooks
Introduction
Zonka Feedback REST APIs allow you to retrieve response details, contacts, surveys, and more. You can use these to pass these details to any application that you or your organization is using such as CRMs, databases, or any custom-built solution.
API Key Authentication
The Zonka Feedback API provides an API token-based authentication system. To access the APIs you would need a valid Auth Token. The token can be created as follows:
Navigate to Company Settings > Developers > API
Select API
Click "Generate Token" to create your token.
API tab is only accessible to Admin users within the Zonka account. The token will have the entire scope of the Admin user and can be used to access all datasets associated with the account.
If you already have a valid API token, "Generate Token" will replace it with a new one (the old one will expire immediately). Any existing API calls will not work until they are updated to use the new token.
Base URLs and Datacenters
Zonka Feedback is hosted in two regions - the United States and European Union.
How to find in which region your Zonka Feedback account is hosted?
Go to Settings on your Zonka Feedback Platform.
In Settings, go to the 'Developers' panel.
In the 'Developers' panel, go to the 'APIs' tab.
Here under the 'Datacenter', you will see the region of your account.
If your region is US, then you can access the public APIs with the base URL provided below
If your region is EU, then you can access the public APIs with the base URL provided below
Responses
API responses will contain JSON objects. Most paginated responses have a default of 25 items returned under the result field. Some API calls will allow the user to override the default page size for paginated responses.
HTTP Response Codes
200 - OK
The request succeeded.
201 - Accepted
When a new object is created in the system.
400 - Bad Request
There was something invalid about the request.
401 - Unauthorized
The API user could not be authenticated or does not have authorization to access the requested resource.
403 - Forbidden
The API user authenticated and made a valid request, but is not authorized to access the requested resource.
404 - Not Found
The requested resource could not be found.
415 - Unsupported Media Type
The request entity has a media type which the server or resource does not support. (Usually the accepts header of the call has an invalid value or a value the server does not support.)
500 - Internal Server Error
This indicates a problem internal to the ZF API and usually cannot be corrected by the user. Please contact Zonka Feedback Support with the requestId and errorCode found in the response.
Date and Time
The Zonka Feedback APIs use date and time values which follow the ISO 8601 standard. Each value represents a specific point in time. Also, some older endpoints feature Unix time instead of ISO 8601.
ISO 8601 Date and Time Format
In general, although the ISO 8601 standard specifies many different date and time formats, the typical date and time value specifies the date as YYYY-MM-DD (where YYYY indicates a four-digit year, MM is a two-digit month, and DD is the two-digit day of the month) followed by the character "T" and then the time as hh:mm:ss (where hh is a two-digit hour in military time format [00-23, no AM or PM], mm is the two-digit minutes past the hour, and ss is the two-digit seconds) followed by the character Z which indicates UTC. Instead of Z, a time zone offset from UTC can be indicated as plus (+) or minus (-) followed by HH:mm.
The following shows examples of ISO 8601 dates and times:
2019-03-21T10:16:12Z000 represents March 21, 2019 at 10:16:12 AM and 0 milliseconds UTC.
2016-04-01T07:31:43Z represents April 1, 2016 at 7:31:43 AM UTC.
2017-02-07T14:02:11-08:00 represents February 7, 2017 at 2:02:11 PM in the PST time zone (UTC minus 8 hours).
All dates and time values returned by the APIs are expressed in UTC unless the API allows you to return values in local time.
Last updated