Integration manifest

Each integration must present a manifest at a known public URL. The manifest describes the capabilities of the integration and provides information that Zendesk Support needs to interact with the integration.

You specify the manifest's URL in the app you build to install the integration in Zendesk Support. For more information, see Channel installer app.

Changes to your manifest are not applied immediately. Zendesk Support polls your manifest, and changes are applied after a poll. For example, if you change the pull_url for your integration, Zendesk Support may continue to connect to the old URL for multiple hours. To avoid outages, when you make changes to your service, you should maintain backwards compatibility for at least a few days. Zendesk Support will follow 301 Moved Permanently redirects for your manifest URL.

Manifest format

The manifest is represented as a JSON object with the following keys.

NameTypeMax charsMandatoryComment
namestring255yesThe name of the integration. Used as the default name of the Channel integration in Zendesk Support
idstring511yesA unique identifier for the integration. A unique URI or GUID is recommended
versionstring255noVersion of this manifest. Zendesk Support uses this to discover if the local cache of manifest data is out of date
authorstring255noName of the author or owner as a plain text string
push_client_idstring127noThe ID of the OAuth client used to generate a token for push support. See Push
channelback_filesbooleannoDoes this integration support Channelbacks with file attachments?
create_followup_ticketsbooleannoWhen the integration returns a thread_id that corresponds to an existing closed Zendesk ticket, and Zendesk creates a new ticket, should it be marked as a "followup" ticket? Most integrations should use true, but messaging or chat oriented integrations might use false. Defaults to true
urlsobjectyesSee the urls object below

urls object

URLs are represented as a JSON object with the following keys. All URLs must be SSL. Relative URLs are supported, and will be interpreted as being relative to the URL of the manifest itself.

NameTypeMax charsMandatoryComment
admin_uistring511yesURL to the HTML interface that Zendesk Support administrators use to configure the integration. See Administrative interface
pull_urlstring511noZendesk Support makes periodic requests to this endpoint to import new content. See Pull requests
channelback_urlstring511noWhen an agent adds a response in Zendesk Support, a POST request is made to this endpoint to push the comment back to the origin service. See Channelback
clickthrough_urlstring511noAgents click a link to this endpoint to see the external resource in the origin system. See Clickthrough endpoint
about_urlstring511noZendesk Support administrators can follow this URL to get a rich description of the service
dashboard_urlstring511noZendesk Support administrators can follow this URL to see detailed information about the status of the service, such as uptime or recent exceptions

Not specifying an optional URL disables the feature in the integration.

Example

{  "name": "Instagram Integration",  "id": "zendesk-internal-instagram-integration",  "author":  "Jared Shay",  "version": "v3.7.5",  "channelback_files": true,  "create_followup_tickets": true,  "urls": {    "admin_ui": "https://omniwear.com/integrations/instagram/admin_ui",    "pull_url": "https://omniwear.com/integrations/instagram/pull",    "channelback_url": "https://omniwear.com/integrations/instagram/channelback",    "clickthrough_url": "https://omniwear.com/integrations/instagram/clickthrough"  }}